이전 버전의 GKE On-Prem 문서를 보고 있습니다. 최신 문서 보기

감사 로깅

개요

Anthos GKE On-Prem은 클러스터의 Kubernetes API 서버에 대한 호출을 시간순으로 기록하는 Kubernetes 감사 로깅을 사용합니다. 감사 로그는 의심스러운 API 요청을 조사하고 통계를 수집하는 데 유용합니다.

Anthos 1.2 이전 버전에서는 GKE On-Prem이 디스크에만 감사 로그를 작성했습니다. Anthos 1.2에는 Google Cloud 프로젝트의 Cloud 감사 로그에 감사 로그를 작성할 수 있는 알파 기능이 도입되었습니다. Cloud 감사 로그에 쓰면 디스크에 쓰거나 온프레미스 로깅 시스템에서 로그를 캡처하는 것보다 몇 가지 이점이 있습니다.

  • 모든 Anthos GKE 클러스터의 감사 로그를 중앙화할 수 있습니다.
  • Cloud 감사 로그에 기록된 로그 항목은 변경할 수 없습니다.
  • Cloud 감사 로그 항목은 400일 동안 보관됩니다.
  • Cloud 감사 로그는 Anthos 가격에 포함되어 있습니다.

GKE On-Prem을 구성하여 디스크 또는 Cloud 감사 로그에 로그를 쓸 수 있습니다.

디스크 기반 감사 로깅

기본적으로 GKE On-Prem의 감사 로그는 영구 디스크에 기록되므로 VM이 다시 시작되고 업그레이드되어도 로그가 사라지지 않습니다. GKE On-Prem은 감사 로그 항목을 최대 10GB까지 보관합니다.

Cloud 감사 로그

Cloud 감사 로그를 사용 설정하면 사용자 클러스터를 만들 때 지정한 프로젝트와 위치를 사용하여 모든 Kubernetes API 서버의 관리자 활동 감사 로그 항목이 Google Cloud로 전송됩니다.

GKE On-Prem은 audit-proxy pod를 관리자 및 사용자 클러스터로 배포합니다. 이 pod는 Cloud 감사 로그에 로그 항목을 버퍼링하고 기록합니다.

제한사항

GKE On-Prem의 Cloud 감사 로그는 알파 기능입니다. 이 알파 출시 버전에는 몇 가지 제한사항이 있습니다.

  • Cloud 감사 로그는 사용자 클러스터를 만드는 동안에만 구성할 수 있습니다. 즉, 새 사용자 클러스터를 만들어야 합니다.

  • 데이터 액세스 로깅은 지원되지 않습니다.

  • Kubernetes 감사 정책 수정은 지원되지 않습니다.

이러한 제한사항은 이후 출시 버전에서 해결될 예정입니다.

Anthos GKE API 사용 설정

GKE On-Prem에서 Cloud 감사 로그를 사용하려면 Anthos GKE API를 사용 설정해야 합니다.

Anthos GKE API 사용 설정

감사 로깅을 위한 서비스 계정 만들기

GKE On-Prem에서 사용하기 위해 만든 여러 서비스 계정이 이미 있습니다. 이 알파 기능을 사용하려면 추가 서비스 계정을 만들고 허용 목록에 추가해야 합니다.

  1. Cloud 감사 로그 서비스 계정을 만듭니다.

    gcloud iam service-accounts create audit-logging-service-account
  2. Cloud 감사 로그 서비스 계정의 JSON 키 파일을 만듭니다.

    gcloud iam service-accounts keys create audit-logging-key.json \
       --iam-account [Cloud Audit Logs_SERVICE_ACCOUNT_EMAIL]
    

    여기서 [Cloud Audit Logs_SERVICE_ACCOUNT_EMAIL]은 Cloud 감사 로그 서비스 계정의 이메일 주소입니다.

  3. 다른 서비스 계정 키와 동일한 위치에 있는 관리 워크스테이션에 audit-logging-key.json을 저장합니다.

서비스 계정을 허용 목록에 추가

Cloud 감사 로그 서비스 계정을 허용 목록에 추가하도록 요청하려면 GKE On-Prem 알파 양식을 위한 Cloud Audit Logging을 작성하세요. Cloud 감사 로그를 사용 설정하는 사용자 클러스터를 만들기 전에 서비스 계정을 허용 목록에 추가해야 합니다.

Cloud 감사 로그가 사용 설정된 사용자 클러스터 만들기

  1. 관리자 클러스터를 아직 만들지 않은 경우 고정 IP 주소를 사용하여 설치 또는 DHCP를 사용하여 설치의 안내에 따라 새 관리자 및 사용자 클러스터를 만듭니다.

    관리자 클러스터가 이미 있는 경우 추가 사용자 클러스터 만들기의 안내에 따라 새 사용자 클러스터를 만듭니다.

  2. gkectl create-config 실행 후 평소와 같이 구성 파일을 채우고 usercluster에서 새로운 cloudauditlogging 섹션도 채웁니다.

  3. cloudauditlogging.projectid는 ACL 사용을 확인하려는 프로젝트 ID 또는 번호입니다.

  4. cloudauditloggijg.clusterlocation을 감사 로그를 저장할 Google Cloud 리전으로 설정합니다. 온프렘 데이터 센터와 가까운 리전을 선택하는 것이 좋습니다.

  5. cloudauditlogging.serviceaccountkeypath를 Cloud 감사 로그 서비스 계정의 JSON 키 파일 경로로 설정합니다.

예를 들면 다음과 같습니다.

cloudauditlogging:
  projectid: "my-project"
  clusterlocation: "us-west1"
  serviceaccountkeypath: "/my-key-folder/audit-logging-key.json"

평소처럼 클러스터 만들기를 계속합니다.

GKE On-Prem 감사 로그 액세스

디스크 기반 감사 로깅

  1. 관리자 클러스터 및 연결된 모든 사용자 클러스터에서 실행 중인 Kubernetes API 서버를 확인합니다.

    kubectl --kubeconfig [ADMIN_CLUSTER_KUBECONFIG] get pods --all-namespaces -l component=kube-apiserver
    

    여기서 [ADMIN_CLUSTER_KUBECONFIG]는 관리자 클러스터의 kubeconfig 파일입니다.

  2. API 서버의 감사 로그를 다운로드합니다.

    kubectl cp -n [NAMESPACE] [APISERVER_POD_NAME]:/var/log/kube-audit/kube-apiserver-audit.log /tmp/kubeaudit.log
    

    이 명령어는 관리자 클러스터에 최대 1GB, 사용자 클러스터에 최대 850GB의 데이터를 포함할 수 있는 최신 로그 파일을 가져옵니다.

    이전 감사 기록은 별도의 파일에 보관됩니다. 이 파일을 보려면 다음 안내를 따르세요.

    kubectl exec -n [NAMESPACE] [APISERVER_POD_NAME] -- ls /var/log/kube-audit -la
    

    각 감사 로그의 파일 이름에는 파일이 회전된 시점을 나타내는 타임스탬프가 있습니다. 파일에는 해당 시간 및 날짜까지의 감사 로그가 포함되어 있습니다.

Cloud 감사 로그

Console

  1. Cloud Console에서 로깅 메뉴의 로그 페이지로 이동합니다.

    로그 페이지로 이동

  2. 위에서 설명한 드롭다운 메뉴 바로 위의 라벨로 필터링 또는 텍스트 검색창에서 아래쪽 화살표를 클릭하여 드롭다운 메뉴를 엽니다. 메뉴에서 고급 필터로 전환을 클릭합니다.

  3. 텍스트 상자에 다음 필터를 입력합니다.

    resource.type="k8s_cluster"
    logName="projects/[PROJECT_ID]/logs/externalaudit.googleapis.com%2Factivity"
    protoPayload.serviceName="anthosgke.googleapis.com"
    
  4. 필터 제출을 클릭하여 이 프로젝트에 로그인하도록 구성된 GKE On-Prem 클러스터의 감사 로그를 모두 표시합니다.

gcloud

프로젝트의 관리자 활동 로그에서 k8s_cluster 리소스 유형에 적용되는 처음 두 로그 항목이 나열됩니다.

gcloud logging read \
    'logName="projects/[PROJECT_ID]/logs/externalaudit.googleapis.com%2Factivity" \
    AND resource.type="k8s_cluster" \
    AND protoPayload.serviceName="anthosgke.googleapis.com" ' \
    --limit 2 \
    --freshness 300d

[PROJECT_ID]는 프로젝트 ID입니다.

출력에 두 로그 항목이 표시됩니다. 각 로그 항목에서 logName 필드의 값은 projects/[PROJECT_ID]/logs/externalaudit.googleapis.com%2Factivity이고 protoPayload.serviceNameanthosgke.googleapis.com과 같습니다.

감사 정책

감사 로깅 동작은 정적으로 구성된 Kubernetes 감사 로깅 정책에 따라 결정됩니다. 이 정책 변경은 현재 지원되지 않지만 이후 버전에서 지원될 것입니다.