로그 뷰어(미리보기) 인터페이스

시작하기 전에

Amazon Web Services(AWS)에서 Logging으로 로그를 전송하는 경우 외에는 Logging을 사용하기 위한 작업공간은 필요하지 않습니다.

작업공간을 사용하면 Logging은 모니터링되는 Google Cloud 프로젝트의 로그를 결합하지 않습니다. 로그를 보려면 특정 Cloud 프로젝트를 선택해야 합니다.

작업공간과 AWS를 사용하는 경우 AWS 커넥터 프로젝트를 선택하여 AWS 로그를 확인합니다.

시작하기

로그 뷰어(미리보기)로 이동하려면 다음을 수행합니다.

  1. Google Cloud 탐색 메뉴 로 이동하고 Logging > 로그 뷰어를 선택합니다.
    로그 뷰어로 이동
  2. Google Cloud 프로젝트를 선택합니다.
  3. 버전 선택 메뉴에서 로그 뷰어 버전을 기본에서 새 로그 뷰어 미리보기로 전환합니다.

이제 로그 뷰어(미리보기)가 표시됩니다.

로그 뷰어 인터페이스

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

로그 뷰어의 사용자 인터페이스

  1. 로그 뷰어 페이지: 쿼리를 빌드, 분석, 상세검색할 수 있습니다.
  2. 조직 및 프로젝트 선택기: 조직 또는 프로젝트 수준에서 로그를 볼 수 있습니다.
  3. 쿼리 빌더: 드롭다운 메뉴 또는 쿼리 빌더 언어를 사용하여 쿼리를 작성할 수 있습니다. 또한 저장된 쿼리를 볼 수 있는 탭이 있습니다.
  4. 로그 필드 탐색기(베타): resource.type, resource.labels, logName, severity 필드의 집계 기반 결과를 볼 수 있습니다. 쿼리를 보다 효율적으로 상세검색할 수 있습니다.
  5. 히스토그램: 로그 데이터의 실행 빈도를 시각화할 수 있습니다.
  6. 쿼리 결과: 쿼리에서 검색한 로그를 볼 수 있습니다.
  7. 로그 항목: 구조화된 JSON 형식의 로그 항목을 볼 수 있습니다.
  8. 시간대: 로그가 표시되는 시간대를 변경할 수 있습니다.
  9. 페이지 레이아웃: 히스토그램로그 필드 탐색기 패널을 사용 설정하거나 중지할 수 있습니다.
  10. 시간 범위 선택기: 시간 범위별로 결과를 제한할 수 있습니다. 기본 시간 범위는 1시간입니다.
  11. 쿼리 실행: 쿼리 빌더 창에서 쿼리를 작성한 후 실행할 수 있습니다.
  12. 현재 시점으로 이동: 현재 시점이 포함되도록 강제로 새로고침을 수행할 수 있습니다. 시간 범위 선택기가 커스텀 범위를 사용하고 종료 시간이 설정된 경우 쿼리는 기본 시간 범위 1시간으로 실행됩니다. 그렇지 않으면 현재 시작 날짜 또는 기간으로 새로 고쳐지고 쿼리가 실행됩니다.
  13. 작업: 로그에서 로그 기반 측정항목 또는 싱크 대상 만들기와 같은 특정 작업을 수행할 수 있습니다.
  14. 구성: 로그 필드 값을 로그 항목의 시작 또는 끝에 있는 요약 줄에 추가할 수 있습니다. 또한 최신 로그를 처음이나 마지막에 표시할 수 있습니다.
  15. 로그 요약 숨기기: 쿼리 결과에서 로그 요약 줄을 숨길 수 있습니다.
  16. 중첩된 로그 필드 펼치기 또는 접기: 중첩된 필드를 펼치거나 접을 수 있습니다.
  17. 클립 보드에 복사: JSON 형식의 로그 항목을 복사할 수 있습니다.
  18. 저장: 저장됨 탭에서 보고 실행할 수 있는 쿼리를 저장할 수 있습니다.
  19. App Engine trace 데이터: trace 세부정보를 보고 trace에 따라 쿼리를 상세검색할 수 있습니다.
  20. 쿼리 결과 펼치기 및 접기: 더 많은 로그 항목을 보도록 쿼리 결과 창을 펼칠 수 있습니다.
  21. 시간 범위 조정: 핸들을 조정하여 쿼리에 사용되는 시간 범위를 변경할 수 있습니다. 핸들을 조정한 후 실행을 클릭하면 쿼리에 사용된 시간 범위가 업데이트됩니다.

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

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

필드 값을 선택한 후의 옵션

요약 필드 추가

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

pod 이름을 로그 앞에 녹색 텍스트로 표시한 로그 뷰어

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

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

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

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

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

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

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

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

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

  2. 필드를 추가합니다.

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

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

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

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

  4. 적용을 클릭합니다.

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

로그 필드 탐색기 패널

로그 필드 탐색기 패널에는 로그 데이터가 상위 수준으로 요약 제공되며, 여기서 쿼리를 보다 효율적으로 상세검색할 수 있습니다. 특정 로그 필드를 기준으로 로그 항목 수가 내림차순으로 정렬되어 표시됩니다. 로그 필드 수는 히스토그램 패널에서 사용되는 시간 범위에 해당합니다.

로그 필드 탐색기는 실행된 쿼리에 따라 채워지고 업데이트됩니다. 빈 쿼리가 있으면 로그 필드 탐색기 패널에 리소스 유형 및 로그 심각도 필드를 기준으로 로그 항목 수가 표시됩니다.

로그 필드 탐색기 패널 사용

로그 필드 탐색기 패널의 필드를 쿼리 빌더에 추가하여 쿼리 범위를 좁히고 상세검색할 수 있습니다. 이렇게 하려면 로그 필드 탐색기 패널에서 필드 값을 클릭합니다. 그러면 로그 필드가 쿼리 빌더에 추가되고 쿼리가 AND 연산자를 통해 원래 쿼리에 표현식으로 추가되어 자동으로 실행됩니다.

쿼리가 실행되면 로그 항목 수가 점진적으로 스캔되므로 로그 필드 수가 점진적으로 로드됩니다. 쿼리가 완료되면 파란색 진행률 표시줄이 종료되고 모든 로그 필드의 총 개수가 표시됩니다.

히스토그램 패널

히스토그램 패널을 통해 시간 경과에 따른 로그 분포를 시각화할 수 있습니다. 이렇게 하면 쉽게 로그 데이터의 추세를 파악하고 문제를 해결할 수 있습니다.

히스토그램 패널 사용 설정

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

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

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

히스토그램 패널 사용

쿼리를 실행하면 히스토그램이 생성됩니다. 히스토그램에는 선택한 기간 동안 일치하는 로그 항목의 빈도가 표시됩니다.

로그 분석

로그 데이터를 분석하려면 히스토그램 패널의 막대 위에 마우스를 가져가고 시간으로 이동을 선택하여 시간 범위를 더 좁게 설정합니다. 그러면 시간 범위 제한이 있는 새 쿼리가 실행됩니다.

시간으로 이동하는 팝업 대화상자를 보여주는 로그 히스토그램

App Engine trace 데이터

App Engine 로그 항목에 trace가 포함되면 지연 시간 칩이 Trace 아이콘과 함께 표시됩니다.

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

trace 지연 시간 칩을 클릭하면 쿼리를 상세검색하고 trace 세부정보를 볼 수 있는 다음 옵션이 표시됩니다.

  • trace 세부정보 보기: 플라이아웃 패널에 trace 세부정보와 함께 상위 스팬 및 하위 trace가 표시됩니다. trace에 대한 자세한 내용을 보려면 Trace에서 보기를 클릭하여 Cloud Trace로 이동합니다. 플라이아웃 패널의 콘텐츠에 대한 자세한 내용은 trace 세부정보 보기를 참조하세요.

  • 이 trace의 모든 로그 표시: 로그 항목과 연결된 trace의 식별자에 trace 필드 세트를 추가하여 쿼리를 상세검색하고 실행합니다.

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

문제해결

이 섹션에서는 로그 뷰어(미리보기)를 사용할 경우의 일반적인 문제를 해결하는 방법을 안내합니다.

Cloud 프로젝트 또는 조직 선택

로그 뷰어(미리보기)를 포함하여 Google Cloud Console 내 원하는 화면에서 Cloud 프로젝트를 선택하려면 프로젝트 및 조직 선택기를 사용합니다.

드롭다운 메뉴에서 프로젝트 선택

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

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

프로젝트 ID 표시

로그 항목을 볼 수 없음

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

  • 올바른 프로젝트가 선택되었는지 확인합니다. 그렇지 않으면 프로젝트 및 조직 선택기에서 올바른 프로젝트를 선택합니다.

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

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

  • 현재 제외 쿼리를 확인하여 원하는 로그가 실수로 제외되지 않았는지 확인합니다.

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

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

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

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

지원 받기

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