로그 탐색기 사용

이 가이드에서는 Google Cloud Console의 로그 탐색기를 사용하여 로그를 검색하고 보는 방법을 설명합니다.

또한 Logging APICloud SDK를 사용하여 로그를 읽을 수 있습니다.

시작하기

로그 탐색기를 사용하려면 다음 사항에 유의하세요.

  • 로그를 볼 수 있는 올바른 Identity and Access Management 역할이 있는지 확인합니다. IAM 권한은 액세스 제어 가이드를 참조하세요.

  • 로그 탐색기로 이동하려면 다음 안내를 따르세요.

    1. Google Cloud 탐색 메뉴로 이동하여 Logging > 로그 탐색기를 차례로 선택합니다.
      로그 탐색기로 이동
    2. 클라우드 프로젝트 선택
    3. 업그레이드 메뉴에서 기존 로그 뷰어로그 탐색기로 전환합니다.

    이제 로그 탐색기가 표시됩니다.

  • Amazon Web Services Elastic Compute Cloud(AWS EC2)를 사용하는 경우 로그 항목은 AWS 계정을 Google Cloud 서비스에 연결하는 AWS 커넥터 프로젝트에 있습니다.

  • BindPlane을 통해 온프레미스 로그와 하이브리드 클라우드 로그를 수집하는 경우 리소스 유형 generic_node에서 로그를 찾을 수 있습니다.

로그 탐색기 인터페이스

로그 탐색기 인터페이스를 사용하면 로그를 검색하고, 로그 데이터를 파싱 및 분석하고, 쿼리 매개변수를 상세검색할 수 있습니다.

로그 탐색기의 사용자 인터페이스

로그 탐색기에는 다음과 같은 창이 포함됩니다.

  1. 작업 모음
  2. 쿼리 빌더
  3. 로그 필드
  4. 히스토그램
  5. 쿼리 결과

작업 모음

작업 모음 창

작업 표시줄 창은 다음 기능을 제공합니다.

  1. 옵션: 기존 로그 뷰어로 이동하여 의견을 보내고 새로운 Logging 기능의 요약을 볼 수 있습니다.
  2. 범위 상세검색: 현재 Cloud 프로젝트만의 로그 또는 하나 이상의 스토리지 뷰를 기준으로 검색 범위를 지정할 수 있습니다. 범위 지정에 대한 자세한 내용은 범위 세분화를 참조하세요.
  3. 링크 공유: 쿼리를 더욱 간편하게 공유할 수 있도록 현재 쿼리의 단축 URL을 만들고 클립보드에 복사합니다. 절대적 기간으로 복사상대적 기간으로 복사라는 두 가지 옵션이 제공됩니다. 절대적 기간으로 복사를 선택하면 복사된 URL에는 현재 기간이 나타내는 절대적 기간이 표시됩니다. 예를 들면 7:49:37 PM - 8:49:37 PM입니다. 상대적 기간으로 복사를 선택하면 복사된 URL에 선택된 현재 상대적 기간이 표시됩니다. 예를 들면 1 hour입니다.
  4. 시간 범위 선택기: 시간 범위별로 쿼리 결과를 제한할 수 있습니다. 기본 시간 범위는 1시간입니다.
  5. 페이지 레이아웃: 히스토그램로그 필드 탐색기 창을 사용 설정하거나 중지할 수 있습니다.
  6. 알아보기: 관련 문서에 대한 링크를 볼 수 있습니다.

범위 상세검색

범위 상세검색 옵션을 통해 로그 탐색기에 표시되는 로그 범위를 상세검색할 수 있습니다. 현재 Cloud 프로젝트 내의 로그만 검색하거나 하나 이상의 스토리지 뷰를 기반으로 로그를 검색할 수 있습니다. 로그 탐색기의 범위를 세분화하려면 다음을 수행합니다.

  1. 작업 모음 창에서 범위 세분화를 선택합니다.

  2. 범위 상세검색 대화상자에서 범위별 옵션을 선택합니다.

    범위 상세검색 대화상자

    • 프로젝트별 범위를 사용하면 현재 Cloud 프로젝트에서 생성되는 로그를 검색할 수 있습니다.

    • 스토리지별 범위를 사용하면 하나 이상의 스토리지 뷰를 기반으로 로그를 검색할 수 있습니다. 로그 뷰에 대한 자세한 내용은 로그 버킷의 로그 뷰 관리를 참조하세요.

  3. 스토리지별 범위를 선택한 경우 보려는 버킷을 하나 이상 선택합니다.

    대화상자에 다음 조건을 충족하는 스토리지 뷰가 나열됩니다.

    • 사용자에게 스토리지 뷰에 대한 액세스 권한이 있습니다.
    • 버킷이 선택한 Cloud 프로젝트에 속하거나 선택한 Cloud 프로젝트가 로그를 스토리지 버킷에 이전에 라우팅했습니다.
  4. 적용을 클릭합니다.

쿼리 빌더

쿼리 빌더

쿼리 빌더 창에서 다음을 수행할 수 있습니다.

  1. 쿼리 빌더 필드: Logging 쿼리 언어를 사용하여 쿼리를 빌드할 수 있습니다.
  2. 쿼리 빌더 드롭다운 메뉴: 리소스, 로그 이름, 심각도를 기반으로 쿼리 표현식을 추가할 수 있습니다. 자세한 내용은 쿼리 빌더 드롭다운 메뉴를 참조하세요.
  3. 최근 쿼리: 최근 쿼리를 볼 수 있습니다. 자세한 내용은 최근 쿼리를 참조하세요.
  4. 저장됨: 저장된 쿼리 및 Cloud 프로젝트의 다른 사용자가 공유한 쿼리를 볼 수 있습니다. 자세한 내용은 저장된 쿼리공유된 쿼리를 참조하세요.
  5. 추천: Cloud 프로젝트의 리소스를 기반으로 추천된 쿼리를 볼 수 있습니다. 자세한 내용은 추천 쿼리를 참조하세요.
  6. 저장: 저장됨 탭에서 보고 실행할 수 있는 쿼리를 저장할 수 있습니다.
  7. 로그 스트림: Logging에서 수집하는 로그 항목을 볼 수 있습니다. 자세한 내용은 로그 스트림을 참조하세요.
  8. 실행: query-builder 필드에서 쿼리를 빌드한 후 쿼리를 실행할 수 있습니다.

로그 스트림

Logging에서 수집한 로그를 스트리밍하거나 쿼리와 일치하는 로그만 스트리밍하는 쿼리를 추가할 수 있습니다.

쿼리를 기반으로 로그를 스트리밍하려면 쿼리 빌더 필드에 쿼리를 추가한 다음 로그 스트림을 선택합니다. Logging에서 로그 데이터를 수집하면 쿼리와 일치하는 로그만 쿼리 결과 창에 표시됩니다. 쿼리가 제공되지 않으면 Logging은 로그를 수집하는 시점에 각 로그를 표시합니다.

로그 스트리밍 전에 쿼리 추가

스트리밍을 중지하려면 스트리밍 중지를 선택하거나 쿼리 결과 창 아래로 스크롤합니다.

로그 필드

로그 필드 창에는 로그 데이터가 상위 수준으로 요약 제공되며, 여기서 쿼리를 보다 효율적으로 상세검색할 수 있습니다. 여기에는 로그 항목이 각 항목의 필드에 해당하는 여러 측정기준별로 분류되어 표시됩니다. 각 필드의 로그 필드 창에는 각 필드의 값과 해당하는 빈도가 내림차순으로 표시됩니다. 로그 필드 수는 시간 범위 선택기의 시간 범위에 해당합니다.

로그 필드 창 사용 설정

로그 필드 창을 사용 설정하려면 페이지 레이아웃을 선택한 다음 로그 필드 체크박스를 선택합니다. 로그 필드 창이 나타납니다.

로그 필드 창이 선택됨

로그 필드 창을 사용 중지하려면 로그 필드 체크박스를 선택 취소합니다.

로그 필드 창 기능

로그 필드 창은 쿼리 빌더에서 실행된 쿼리에 따라 채워지고 업데이트됩니다.

빈 쿼리가 있으면 로그 필드 창에 리소스 유형심각도 필드를 기준으로 로그 항목 수가 표시됩니다.

로그 필드 창.

스토리지별 범위를 선택한 경우 프로젝트 ID와 이에 상응하는 로그 항목 수도 표시됩니다.

로그 필드 창에서 리소스 유형을 선택할 경우 리소스 라벨을 기준으로 관련 필드 집합이 표시됩니다. 이렇게 하면 특정 리소스 유형의 로그 데이터를 조사할 수 있습니다. 리소스 유형 필드 옆에 있는 지우기를 클릭하여 삭제할 수 있습니다.

로그 필드 창에 필드 추가

쿼리 결과 창에 입력된 로그 항목에서 특정 LogEntry 키-값 쌍을 로그 필드 창에 추가할 수 있습니다. 로그 필드 창에 필드를 추가하려면 다음을 수행합니다.

  1. 쿼리 결과 창에서 펼치기 버튼 을 클릭하여 로그 항목을 펼칩니다.

  2. 필드 값을 마우스 왼쪽 버튼으로 클릭합니다. 메뉴에서 로그 필드에 필드 추가 창을 선택합니다.

    필드 추가 옵션이 있는 메뉴

    커스텀 필드는 로그 필드 창에 키-값 쌍 목록으로 나타납니다.

로그 필드 창에서 커스텀 필드를 삭제하려면 필드 옆에 있는 삭제를 클릭합니다. 쿼리 결과 창에서 커스텀 필드를 마우스 왼쪽 버튼으로 클릭하고 로그 필드에서 삭제를 선택하여 목록에서 삭제할 수도 있습니다.

참고로 다음 유형의 필드는 로그 필드 창에 추가할 수 없습니다.

  • 시간 관련 필드. 예를 들면 receiveTimestampprotoPayload.startTime입니다.
  • 카디널리티가 높은 필드. 예를 들면 insertIdprotoPayload.latency입니다.
  • 경로에 배열 색인이 있는 필드. 예를 들면 protoPayload.authorizationInfo[0].resource입니다.

로그 필드 창을 사용하여 로그 분석

쿼리 범위를 좁히고 상세검색하려면 로그 필드 창에서 쿼리 빌더 표현식에 필드-값 쌍을 추가하면 됩니다. 이렇게 하려면 로그 필드 창에서 필드 값을 클릭합니다. AND 연산자를 사용하여 표현식에 필드-값 쌍을 추가합니다. 그러면 쿼리가 실행됩니다.

로그 필드 창에 중첩된 필드-값 쌍과 최상위 필드-값 쌍을 추가할 수 있습니다.

예를 들어 로그 필드 창에 jsonPayload.message를 추가했다고 가정합니다. 특정 jsonPayload.message 값을 선택하면 쿼리 빌더 창이 채워집니다.

로그 필드 및 커스텀 필드가 추가된 쿼리 빌더 창

히스토그램쿼리 결과 창도 현재 쿼리를 반영하도록 변경됩니다.

쿼리가 실행될 때 로그 항목이 검사되고 로그 필드 수가 변경됩니다. 쿼리가 완료되면 모든 로그 필드의 총 개수가 표시됩니다.

히스토그램

히스토그램 창을 통해 시간 경과에 따른 로그 분포를 시각화할 수 있습니다. 히스토그램은 쿼리를 실행할 때 재생성되므로 로그 데이터의 추세를 더 쉽게 확인하고 문제를 해결할 수 있습니다.

히스토그램 창 사용 설정

히스토그램 창을 사용 설정하려면 페이지 레이아웃을 선택한 다음 히스토그램 체크박스를 선택합니다. 히스토그램 창이 표시됩니다.

페이지 레이아웃이 열리고 히스토그램이 선택됨

히스토그램 창을 사용 중지하려면 히스토그램 체크박스를 선택 취소합니다.

히스토그램 기능

히스토그램 창.

  1. 히스토그램 막대: 각 히스토그램 막대는 시간 범위를 나타냅니다. 각 막대에는 각 막대의 시간 범위에 캡처된 로그 심각도 수준에 대한 세 가지 색상별 분석이 포함됩니다. 색상은 다음과 같은 로그 심각도를 나타냅니다.

    • 파란색: 기본, 디버그, 정보, 알림과 같은 낮은 심각도입니다.
    • 노란색: 경고와 같은 중간 심각도입니다.
    • 빨간색: 오류, 심각, 알림, 긴급과 같은 높은 심각도입니다.

    각 히스토그램 바에는 로그 분석 옵션이 있는 메뉴가 있습니다.

  2. 시간 컨트롤: 쿼리에 사용된 시간을 조정할 수 있습니다. 이러한 옵션에 대한 자세한 내용은 시간 컨트롤을 사용하여 로그 분석을 참조하세요.

  3. 히스토그램 타임라인: 현재 쿼리 결과 창에 표시되는 로그의 시간 범위가 히스토그램 막대로 표시됩니다. 타임라인을 사용하면 쿼리의 더 큰 시간 범위 내에서 현재 보고 있는 로그를 전달할 수 있습니다.

시간 제어를 사용하여 로그 분석

히스토그램의 시간 컨트롤을 사용하여 로그 데이터를 조사하고 분석할 수 있습니다.

신속한 시간 조정

히스토그램은 로그 탐색기에 표시되는 데이터를 빠르게 조정할 수 있는 시간 컨트롤을 제공합니다.

히스토그램 창 타임라인에 빠른 시간 컨트롤이 표시됩니다.

  • 시간 핸들: 타임라인의 핸들을 안쪽으로 드래그하여 데이터 범위를 좁히거나 바깥쪽으로 드래그하여 히스토그램 타임라인의 데이터를 범위를 넓힙니다. 실행을 클릭합니다.

  • 타임라인을 앞뒤로 슬라이드: 앞으로 화살표를 클릭하여 타임라인을 나중 시간으로 슬라이드합니다. 타임라인을 이전 시간으로 슬라이드하려면 뒤로 화살표를 클릭합니다.

  • 확대 및 축소: 축소 아이콘을 클릭하면 타임라인에 표시되는 데이터가 확장됩니다. 타임라인에 표시되는 데이터의 범위를 좁히려면 확대 아이콘을 클릭합니다.

이러한 시간 컨트롤을 사용하면 쿼리 결과로그 필드 창의 로그 데이터가 히스토그램 타임라인에서 캡처한 시간 범위에 따라 조정됩니다.

타임라인 수정은 현재 시점('지금')과 30일 전 사이의 기간으로 제한됩니다.

시간으로 스크롤 또는 확대/축소

위의 시간 컨트롤 외에도 히스토그램은 시간으로 스크롤시간으로 확대/축소 기능을 제공하여 더 세부적으로 히스토그램 및 로그 탐색기의 다른 창에 표시되는 데이터를 제어할 수 있습니다.

히스토그램 창 타임라인에 시간으로 스크롤 및 시간으로 확대/축소 컨트롤이 표시됩니다.

상대적 크기 또는 심각도 수준에 따라 특정 히스토그램 막대에 관심이 있을 수 있습니다. 해당 히스토그램 막대를 선택하여 로그 탐색기에 표시되는 로그 데이터를 조정할 수 있습니다.

시간으로 스크롤 기능을 사용하면 히스토그램로그 필드 창에서 값을 변경하지 않고 로그 데이터를 찾아볼 수 있습니다. 시간으로 스크롤 기능을 선택하면 다음 작업이 수행됩니다.

  • 쿼리 결과 창에 표시되는 로그 데이터가 선택한 히스토그램 막대로 캡처된 시간 범위에 따라 조정됩니다.

    쿼리가 실행되지 않지만 선택한 히스토그램 막대의 시간 범위에 따라 쿼리 결과 창에 로그가 표시되도록 데이터에 대한 일부 새로고침이 수행될 수 있습니다.

  • 선택한 히스토그램 막대의 시간 범위에 캡처된 최근 로그의 timestamp를 포함하도록 Console URL이 업데이트됩니다.

시간으로 스크롤 기능을 선택하려면 다음을 수행합니다.

  1. 히스토그램 타임라인에서 막대 위로 마우스를 가져갑니다. 지정된 시간 범위의 로그 데이터에 대한 요약 정보가 포함된 창이 표시됩니다.

  2. 창에서 시간으로 스크롤을 선택합니다.

    또는 마우스를 가져가는 대신 히스토그램 막대를 클릭하는 것도 시간으로 스크롤을 선택하는 것과 동일합니다.

시간으로 확대/축소 기능은 시간으로 스크롤과 비슷하지만 선택한 히스토그램 막대로 캡처된 시간 범위를 기준으로 로그 데이터에 대해 쿼리를 실행합니다. 시간으로 확대/축소 기능을 선택하면 다음 작업이 수행됩니다.

  • 쿼리 결과 창에 표시되는 로그 데이터가 새로고침되고 선택한 히스토그램 막대의 시간 범위 제한에 따라 제한됩니다.
  • 선택한 히스토그램 막대의 시간 범위에 캡처된 최근 로그의 timestamp를 포함하도록 Console URL이 업데이트됩니다.
  • 히스토그램이 선택한 히스토그램 막대의 시간 범위 내에 있는 timestamp 값이 포함된 로그만 표시하도록 변경됩니다.
  • 시간 범위 선택기가 선택한 히스토그램 막대로 캡처된 시간 범위로 업데이트됩니다.
  • 로그 필드 창의 데이터가 선택한 히스토그램 막대로 캡처되는 시간 범위에 따라 조정됩니다.

시간으로 확대/축소 기능을 선택하려면 다음을 수행합니다.

  1. 히스토그램 타임라인에서 막대 위로 마우스를 가져갑니다. 지정된 시간 범위의 로그 데이터에 대한 요약 정보가 포함된 창이 표시됩니다.

  2. 창에서 시간으로 확대/축소를 선택합니다.

쿼리 결과

쿼리 결과 창

쿼리 결과 창에서 쿼리 표현식과 일치하는 로그 항목을 탐색할 수 있습니다.

  1. 쿼리 결과: 쿼리에서 검색한 로그를 볼 수 있습니다.
  2. 로그 항목: 구조화된 JSON 형식의 로그 항목을 볼 수 있습니다.
  3. 쿼리 결과 펼치기 및 접기: 더 많은 로그 항목을 보도록 쿼리 결과 창을 펼칠 수 있습니다.
  4. 시간대: 로그가 표시되는 시간대를 변경할 수 있습니다.
  5. trace 데이터: trace 세부정보를 보고 trace를 기반으로 쿼리를 상세검색할 수 있습니다. 자세한 내용은 trace 데이터 보기를 참조하세요.
  6. 로그 요약 숨기기: 쿼리 결과에서 로그 요약 줄을 숨길 수 있습니다.
  7. 중첩된 로그 필드 펼치기 또는 접기: 중첩된 필드를 펼치거나 접을 수 있습니다.
  8. 클립 보드에 복사: JSON 형식의 로그 항목을 복사할 수 있습니다.
  9. 로그 항목에 링크 복사: 로그 항목에 대한 링크를 공유할 수 있습니다. 자세한 내용은 로그 항목에 링크 복사를 참조하세요.
  10. 현재 시점으로 이동: 현재 시점이 포함되도록 강제로 새로고침을 수행할 수 있습니다. 시간 범위 선택기가 커스텀 범위를 사용하고 종료 시간이 설정된 경우 쿼리는 기본 시간 범위 1시간으로 실행됩니다. 그렇지 않으면 현재 시작 날짜 또는 기간으로 새로 고쳐지고 쿼리가 실행됩니다.
  11. 작업: 로그 기반 측정항목을 설정하거나 싱크 대상을 만들거나 로그를 다운로드할 수 있습니다. 로그를 다운로드하는 방법에 대한 자세한 내용은 로그 다운로드를 참조하세요.
  12. 구성: 로그 필드 값을 로그 항목의 시작 또는 끝에 있는 요약 줄에 추가할 수 있습니다. 또한 최신 로그를 처음이나 마지막에 표시할 수 있습니다. 요약 필드 추가에 대한 자세한 내용은 요약 필드 추가를 참조하세요.
  13. 로그 항목 고정: 쿼리 결과히스토그램 창에 로그 항목을 고정할 수 있습니다. 자세한 내용은 로그 고정을 참조하세요.
  14. 커서 스크롤: 쿼리 결과에서 로그를 스크롤하면 현재 쿼리 결과 창에 표시된 최신 로그의 timestamp를 나타내는 cursorTimestamp를 포함하도록 URL이 조정됩니다.

쿼리 결과 창에서 필드 값을 클릭하여 다음을 수행하도록 선택할 수 있습니다.

필드 값을 선택한 후의 옵션

  1. 일치하는 항목 표시: 일치하는 로그 항목을 쿼리할 수 있습니다.
  2. 일치 항목 숨기기: 선택한 표현식과 일치하지 않는 로그 항목을 쿼리할 수 있습니다.
  3. 요약 줄에 필드 추가: 필드를 로그 항목의 요약 줄로 추가할 수 있습니다.

요약 필드 추가

요약 필드를 사용하면 로그의 패턴을 더 빠르게 확인할 수 있습니다. 예를 들어 다음 이미지는 값이 포함된 로그 앞에 추가된 요약 필드 resource.labels.pod_name 값을 표시합니다.

로그 탐색기가 로그 앞에 포드 이름을 녹색 텍스트로 표시합니다.

로그 항목에서 요약 필드 추가

로그 항목에 요약 필드를 추가하려면 다음 단계를 완료합니다.

  1. 펼치기 버튼 을 클릭하여 로그 항목을 펼칩니다.

  2. 필드 값을 클릭한 후 요약 줄에 필드 추가를 선택합니다.

    이제 요약 필드가 해당 필드가 포함된 로그 항목 앞에 표시됩니다.

구성 버튼을 사용하여 요약 필드 추가

구성 버튼을 사용하여 요약 필드를 추가하려면 다음 단계를 완료합니다.

  1. 구성을 클릭하고 요약 필드 관리를 선택합니다.

    요약 필드 관리가 선택된 구성 드롭다운 메뉴

  2. 필드를 추가합니다.

    요약 필드 선택에는 다음과 같은 기능이 있습니다.

    • 현재 표시된 로그를 사용하여 자동 완성
    • 따옴표 안에 있는 리걸 문자의 필드 수정

      예를 들어 jsonPayload.id-field를 입력하면 jsonPayload."id-field"로 변경됩니다.

  3. 요약 필드 값 표시를 줄이려면 요약 필드 자르기를 클릭합니다. 그런 다음 필드를 자르기 전에 표시할 문자 수와 필드의 시작과 끝 중 표시할 부분을 선택합니다.

  4. 적용을 클릭합니다.

    이제 요약 필드가 해당 필드가 포함된 로그 항목 앞에 표시됩니다.

로그 항목 고정

로그 항목을 고정하여 관심 있는 로그 항목을 강조표시할 수 있습니다.

로그 항목을 고정하려면 고정하려는 로그 항목 위로 마우스를 가져간 후 고정 아이콘 을 선택합니다. 로그 항목을 고정하면 배경이 어두워지고 고정 아이콘 이 표시됩니다.

로그 항목을 고정하고 쿼리를 다시 실행하면 로그 데이터 구성 방법에 따라 고정된 로그 항목이 쿼리 결과 창의 상단 또는 하단에 표시됩니다. 또한 고정된 로그 항목의 timestamp를 기반으로 히스토그램 창에 고정 아이콘이 표시됩니다.

로그 탐색기의 쿼리 결과 및 히스토그램 창에 고정된 로그 항목이 표시됩니다.

로그 항목을 고정 해제하려면 고정 아이콘을 선택한 후 로그 항목 고정 해제를 선택합니다.

리소스 컨텍스트에서 고정된 로그 항목 보기

리소스 컨텍스트 내에서 고정된 로그 항목을 보려면 고정 아이콘 을 선택한 다음 리소스 로그 항목 고정 및 표시를 선택합니다.

리소스 컨텍스트에서 고정 및 표시가 선택되어 있습니다.

Logging은 고정된 로그 항목의 resource.type 필드로 쿼리 빌더를 채우고 쿼리를 실행합니다. 이제 리소스 유형과의 관계로 고정된 로그 항목을 볼 수 있습니다.

히스토그램 창에서 고정된 로그 항목 보기

히스토그램 창을 사용하여 고정된 로그 항목을 강조표시하고, 스크롤하고, 추가로 조사할 수 있습니다.

히스토그램 창을 사용하여 고정 아이콘 을 선택한 후 다음 메뉴 옵션 중에서 선택합니다.

  • 로그 항목으로 스크롤: 이 옵션을 사용하면 로그 항목을 현재 쿼리 결과 창으로 가져오고 근처에 있는 로그의 컨텍스트로 고정된 로그 항목을 볼 수 있습니다.
  • 로그 항목으로 확대/축소: 이 옵션을 사용하면 히스토그램 창이 표시할 수 있는 시간 범위를 제한하고 고정된 로그 근처의 로그를 격리하도록 쿼리를 세분화할 수 있습니다.

히스토그램 기간이 좁혀졌습니다.

trace 데이터 보기

로그 항목에 trace 및 지연 시간 관련 필드가 모두 포함된 경우 지연 시간과 trace 아이콘이 모두 표시됩니다.

trace 데이터가 포함된 로그 항목 표시

로그 항목에 trace 필드만 포함된 경우에는 trace 아이콘만 표시됩니다.

trace 필드만 포함된 로그 항목 화면에는 trace 아이콘이 있습니다.

로그 항목과 관련된 trace 데이터를 보려면 trace 아이콘을 클릭하세요. 선택할 수 있는 옵션은 다음과 같습니다.

  • trace 세부정보 보기: trace 세부정보와 함께 상위 스팬 및 하위 trace가 표시됩니다. trace에 대한 자세한 내용을 보려면 Trace에서 보기를 클릭하여 Cloud Trace로 이동합니다. 세부정보 패널 콘텐츠에 대한 자세한 내용은 trace 세부정보 보기를 참조하세요.
  • 이 trace의 모든 로그 표시: 로그 항목과 연결된 trace의 식별자에 trace 필드 세트를 추가하여 쿼리를 상세검색하고 실행합니다.

  • 추적된 요청만 표시: traceSampled 필드를 True로 설정하여 쿼리를 상세검색하고 실행합니다. 샘플링에 대한 자세한 내용은 샘플링 레이트를 참조하세요.

Monitoring 데이터 보기

GKE 및 Compute Engine 로그 등 특정 로그의 경우 로그 요약 줄에서 리소스 유형을 클릭하여 다음 옵션이 있는 메뉴를 표시할 수 있습니다.

  • 모니터링 세부정보 보기: GKE 리소스의 세부정보 패널을 엽니다. 세부정보 패널은 리소스 세부정보 보기를 참조하세요.
  • Monitoring에서 보기: 리소스의 Monitoring 페이지가 열립니다.
  • GKE에서 보기: GKE 또는 Compute Engine 사용자 인터페이스 내에서 리소스의 세부정보 페이지를 엽니다.

GKE 리소스의 로그 탐색기 메뉴 표시

로그에 링크를 공유하려면 로그 항목을 확장하고 링크 복사를 선택합니다. 링크가 클립보드에 복사됩니다. 이제 Cloud 프로젝트에 대한 액세스 권한이 있는 사용자에게 링크를 보낼 수 있습니다. 사용자가 링크를 브라우저에 붙여넣거나 선택하면 Logging이 로그 항목을 해당 쿼리 결과 창에 고정합니다.

다른 사람과 로그 항목을 공유하려면 링크를 복사합니다.

로그 다운로드

로그를 CSV 또는 JSON 형식으로 다운로드할 수 있습니다. 로그를 다운로드하려면 다음 Identity and Access Management 역할 중 하나가 필요합니다.

  • Logging 관리자(roles/logging.admin)
  • 로그 뷰 접근자 (roles/logging.viewAccessor)

로그를 다운로드하려면 다음 절차를 따르세요.

  1. 작업을 선택한 후 로그 다운로드를 선택합니다.

    작업 버튼으로 로그 다운로드

  2. 로그 다운로드 대화상자에서 CSV 또는 JSON 형식을 선택합니다.

  3. 로그 데이터로 수행할 작업을 선택합니다. 선택할 수 있는 옵션은 다음과 같습니다.

    • 데이터를 컴퓨터에 다운로드합니다.
    • 데이터를 드라이브에 다운로드합니다.
    • 새 탭에서 데이터를 봅니다.

    CSV를 저장하고 드라이브를 선택하면 스프레드시트에서 파일을 열 수 있습니다.

쿼리 예시

로그 탐색기를 사용하는 샘플 쿼리 페이지에서는 추천 쿼리를 제공하므로 관심 있는 로그를 찾을 수 있습니다. 예를 들어 Kubernetes 관련 쿼리를 실행하여 Google Kubernetes Engine 로그를 찾을 수 있습니다.

문제 해결

이 섹션에서는 로그 탐색기를 사용할 때 발생하는 일반적인 문제를 해결할 수 있는 안내를 설명합니다.

Cloud 프로젝트 또는 조직 ID 가져오기

Google Cloud Console의 모든 위치에서 Cloud 프로젝트 또는 조직 ID를 가져오려면 Cloud 프로젝트 및 조직 선택기에서 Cloud 프로젝트 목록을 펼치고 ID 열에서 Cloud 프로젝트 ID를 찾습니다.

프로젝트 ID 표시

로그 항목을 볼 수 없음

로그 항목이 표시되지 않으면 다음을 확인합니다.

  • 올바른 Cloud 프로젝트가 선택되어 있나요? 그렇지 않으면 Cloud 프로젝트 및 조직 선택기에서 올바른 Cloud 프로젝트를 선택하세요.

  • Cloud 프로젝트에서 로그를 생성하는 리소스를 사용하고 있으며 이러한 리소스에 대한 활동이 있는지 확인합니다. 새 Cloud 프로젝트인 경우에도 프로젝트가 생성되었다는 사실을 기록한 감사 로그가 있어야 합니다. 모니터링된 리소스 목록 페이지의 '리소스 유형에 서비스 매핑' 섹션으로 이동하여 로그를 생성하는 리소스를 사용 중인지 확인합니다.

  • 기간이 너무 짧지 않은지 확인합니다. 쿼리의 기간이 올바른지 확인합니다.

  • 현재 제외 쿼리에서 찾으려는 로그가 실수로 제외되지 않았는지 확인합니다.

쿼리가 올바르지만 여전히 로그 항목이 표시되지 않음

  • Logging 보관 기간보다 오래된 로그 항목은 볼 수 없습니다. 적용되는 로그 보관 기간은 로그 보관 기간을 참조하세요.

  • 부하량이 높은 기간에는 로그를 Logging으로 전송하거나 로그를 수신하고 표시하는 데 지연이 발생할 수 있습니다.

  • 타임스탬프가 미래로 지정된 로그 항목의 경우 현재 시간이 해당 타임스탬프에 '도달할 때'까지 로그 탐색기에 로그 항목이 표시되지 않습니다. 이는 일반적인 경우는 아니며 로그를 전송하는 애플리케이션의 시간차로 인해 발생할 수 있습니다.

  • 쿼리 범위가 너무 크게 설정되어 있어 적절한 시간 내에 완료할 수 없습니다. '작업이 만료되기 전에 기한 만료'로 표시될 수 있습니다. 쿼리를 더 구체적으로 만들거나 기간을 줄여보세요.

쿼리에서 오류를 반환함

버킷을 지정하지 않고 리소스에 쿼리를 실행하면 Cloud Logging이 Google Cloud 프로젝트의 싱크 기록을 사용하여 리소스에 대한 항목이 작성되었을 수 있는 위치를 확인합니다. Cloud Logging이 항목이 작성되었을 수 있는 버킷을 200개 넘게 식별하면 쿼리가 Error: Invalid query 메시지와 함께 실패합니다.

이 문제를 해결하려면 쿼리 범위를 스토리지의 하위 집합으로 미세 조정합니다. 자세한 내용은 범위 미세 조정을 참조하세요.

지원 받기

지원 받기에 대한 자세한 내용은 Google Cloud의 작업 제품군 지원 페이지를 참조하세요.