Cloud Storage FUSE 로그를 Cloud Logging으로 전달

이 페이지에서는 Cloud Storage FUSE 로그를 Cloud Logging으로 전달하는 방법을 설명합니다.

개요

Cloud Storage FUSE 로그는 Cloud Storage FUSE의 작동 방식을 파악하고 문제를 해결하며 성능을 모니터링하는 데 도움이 됩니다. --log-severity CLI 옵션 또는 logging:severity 구성 필드를 사용하여 로그를 생성하면 Cloud Storage FUSE에서 로그가 생성되며 Cloud Storage FUSE가 실행되는 머신에서 표준 출력 또는 로컬 로그 파일로 볼 수 있습니다.

Cloud Storage FUSE 로그를 Cloud Logging으로 전달할 수도 있으며, 이 경우 다음과 같은 이점이 있습니다.

  • Trusted Cloud 콘솔의 단일 위치에서 모든 Cloud Storage FUSE 로그를 확인하여 Cloud Storage FUSE 동작을 전체적으로 파악하고 다양한 구성요소 간의 이벤트를 더 쉽게 상호 연관시킬 수 있습니다.

  • 심각도 수준, 타임스탬프, 리소스 유형, 기타 필드를 기준으로 Cloud Storage FUSE 로그를 필터링하여 오류나 성능 문제를 정확히 파악할 수 있습니다.

  • 특정 로그 이벤트에 의해 트리거되는 측정항목 기반 알림을 만듭니다. 예를 들어 Cloud Storage FUSE의 error 또는 warning 로그 메시지가 감지될 때마다 알림을 받도록 설정하여 문제에 선제적으로 대응할 수 있습니다.

  • 구성 가능한 기간 동안 Cloud Logging에 로그를 저장하고 장기 저장, 보관처리 또는 심층 분석을 위해 Cloud Storage로 내보냅니다.

가격 책정

Cloud Logging 가격 책정 정보는 Cloud Logging 비용을 참조하세요.

필요한 역할 얻기

Cloud Logging을 사용하여 Cloud Storage FUSE 로그를 보는 데 필요한 권한을 얻으려면 측정항목을 수집하려는 프로젝트에 로그 작성자(roles/logging.logWriter) IAM 역할을 부여합니다.

이 사전 정의된 역할에는 Cloud Logging을 사용하는 데 필요한 권한이 포함되어 있습니다. 로그 작성자 역할에 대한 자세한 내용은 roles/logging.logWriter에 대한 IAM 문서를 참조하세요.

프로젝트에 역할을 부여하는 방법은 프로젝트에 대한 액세스 관리를 참조하세요.

시작하기 전에

  1. Cloud Storage API를 사용 설정합니다.

    Cloud Storage API로 이동

  2. Cloud Logging API를 사용 설정합니다.

    Cloud Logging API로 이동

  3. 로그 및 측정항목을 수집하는 Trusted Cloud by S3NS의 기본 에이전트인 Cloud 운영 에이전트를 설치합니다. 사용 중인 가상 머신 유형에 따라 설치 방법을 선택합니다.

  4. --log-severity CLI 옵션 또는 severity 필드를 trace로 설정하여 로깅 심각도를 trace로 설정합니다.

Cloud Storage FUSE 로그를 Cloud Logging으로 전달

  1. gcsfuse 마운트에 /gcsfuse.log를 지정합니다.

    logging:
      file-path: "/gcsfuse.log"
      severity: trace
    
  2. 다음 구성을 사용하여 /gcfuse.log 파일의 로그를 Cloud Logging으로 전달하도록 Cloud 운영 에이전트를 구성합니다. 이 구성에서 gcsfuse_trace_logs/gcsfuse.log 파일에서 로그를 수신하는 receiver 요소입니다. service 요소는 파이프라인의 receiver 요소를 연결합니다.

    logging:
     receivers:
      gcsfuse_trace_logs:
      type: files
      include_paths:
      - /gcsfuse.log
    service:
     pipelines:
       gcsfuse_pipeline:
         receivers: [gcsfuse_trace_logs]
    

    추가 로깅 구성에 대해 알아보려면 Cloud Logging 구성을 참조하세요.

  3. 운영체제에 따라 Cloud 운영 에이전트의 구성을 경로에 입력합니다. 구성을 배치할 경로를 선택하려면 사용자 지정 구성에 관한 Google Cloud Observability 문서를 참조하세요.

  4. systemctl restart 명령어를 사용하여 Cloud 운영 에이전트를 다시 시작하여 새 구성 변경사항을 가져옵니다.

    sudo systemctl restart google-cloud-ops-agent`
    
  5. Trusted Cloud 콘솔에서 Cloud Logging으로 이동합니다.

  6. fuse_debug 필터링 쿼리를 실행하여 Cloud Logging으로 전달된 gcsfuse 추적 로그를 검증합니다.

다음 단계