기본 로그 필터

이 가이드에서는 로그 뷰어 기본 필터 인터페이스에서 라벨 또는 텍스트 검색을 통해 로그 항목을 필터링하는 방법을 설명합니다.

자세한 고급 로그 필터링 옵션은 고급 로그 필터를 참조하세요.

로그 항목을 내보내려면 로그 내보내기를 참조하세요. Logging API를 통해 로그 항목을 읽으려면 entries.list를 참조하세요. SDK를 사용하여 로그 항목을 읽으려면 로그 항목 읽기를 참조하세요.

기본 필터로 시작하기

  1. GCP Console에서 Stackdriver Logging > 로그(로그 뷰어) 페이지로 이동합니다.

    로그 뷰어 페이지로 이동

  2. 페이지 상단에서 기존 GCP 프로젝트를 선택하거나 새 프로젝트를 만듭니다.

  3. 드롭다운 메뉴를 사용하여 확인할 로그의 리소스를 선택합니다.

다음 스크린샷에서는 기본 로그 필터 인터페이스를 보여줍니다. App Engine 애플리케이션의 네 가지 로그 항목이 표시됩니다. 두 번째 항목은 확장 화살표(▸)를 클릭하여 펼쳐진 상태입니다.

로그 뷰어

기본 로그 필터 인터페이스에는 위의 스크린샷에서 빨간색 숫자로 표시된 주요 구성요소가 있으며, 이러한 구성요소 중 일부는 고급 필터 인터페이스와 공유됩니다.

  1. 창 탭에서 로그(로그 뷰어), 측정항목(로그 기반 측정항목 참조), 내보내기(로그 내보내기 참조), 로그 수집(로그 제외 참조)를 선택할 수 있습니다.
  2. 기본 로그 필터 인터페이스에서 검색-필터 상자를 사용하면 라벨 또는 텍스트 검색을 통해 로그 항목을 필터링할 수 있습니다. 기본 로그 필터 인터페이스가 표시되며 오른쪽 끝에 있는 드롭다운 화살표(▾)를 사용하면 고급 로그 필터 인터페이스로 전환하거나 필터 링크를 가져올 수 있습니다.
  3. 기본 선택기 메뉴를 사용하면 표시할 리소스, 로그, 심각도 수준을 선택할 수 있습니다.
  4. 시간 범위 선택기 드롭다운 메뉴를 사용하면 로그에서 특정 날짜와 시간을 필터링할 수 있습니다.
  5. 페이지 상단의 스트리밍 선택기는 새 로그 항목이 도착하면 바로 표시할지를 제어합니다.
  6. 로그 항목 테이블에는 현재 필터와 커스텀 필드에 따라 볼 수 있는 로그 항목이 표시됩니다.
  7. 각 로그 항목 앞에 있는 펼치기 화살표(▸)를 클릭하면 항목의 전체 내용을 볼 수 있습니다. 자세한 내용은 로그 항목 펼치기를 참조하세요.
  8. 오른쪽 끝에 있는 보기 옵션 메뉴에는 추가 표시 옵션이 있습니다.
  9. 오른쪽 끝에 있는 로그 다운로드 메뉴를 사용하면 로그 항목의 집합을 다운로드 할 수 있습니다.
  10. 각 로그 항목과 함께 표시되는 More(⋮) 옵션을 사용하면 로그 항목에 핀을 배치하고, 로그 항목을 리소스 컨텍스트에서 표시하고, 로그 항목의 URL을 클립보드에 복사할 수 있습니다.

마지막으로 로그 뷰어는 커서 위치를 사용하여 연관된 로그 항목을 강조표시하고 더보기(⋮) 옆에 푸시 핀(📌) 기호를 배치합니다.

기본 검색

기본 로그 필터 인터페이스에서 메뉴 위에 있는 검색-필터 상자에 텍스트를 입력한 후 ENTER 키를 누릅니다. 어디서나 어느 필드에서나(timestamp 제외) 대소문자에 관계없이 입력한 검색어가 포함된 모든 로그 항목이 검색 결과로 반환됩니다. 로그 뷰어가 검색어 앞에 추가하는 text: 단어는 '모든 필드' 검색임을 나타냅니다.

다음은 일반적인 검색 몇 가지와 사용자의 예상대로 실행되지 않는 몇 가지 검색의 예입니다.

일반적인 기본 검색의 예

Unicorn (text:Unicorn)

어떤 필드에서든 대소문자에 관계없이 unicorn이 포함된 모든 로그 항목을 찾습니다.

unicorn phoenix (text:unicorn text:phoenix)

동일한 필드나 여러 필드에서 unicorn 또는 phoenix가 포함된 모든 로그 항목을 찾습니다. 두 용어가 모두 포함된 로그 항목을 원하면 고급 로그 필터 인터페이스를 사용합니다.

"unicorn phoenix" (text:"unicorn phoenix")

동일한 필드에서 대소문자에 관계없이 정확히 공백 하나로 구분된 unicorn phoenix가 포함된 모든 로그 항목을 찾습니다. 기본 로그 필터 인터페이스에서는 '동일한 필드 어디서나 unicornphoenix' 검색이 지원되지 않지만 고급 로그 필터 인터페이스에서는 지원됩니다.

-unicorn (-text:unicorn)

어떤 필드에서든 대소문자에 관계없이 unicorn이 포함된 모든 로그 항목을 찾고 표시된 항목에서 제외합니다. 기본 로그 필터 인터페이스에서는 동일한 필드 또는 서로 다른 필드에서의 '-unicorn-phoenix' 검색이 지원되지 않지만 고급 로그 필터 인터페이스에서는 지원됩니다.

2345 (text:2345)

2345라는 문자열을 포함하는 모든 로그 항목을 찾습니다. 로그 항목 안의 숫자는 일반적으로 문자열로 표시되므로 123456 등과 일치합니다.

사용자의 예상대로 실행되지 않는 검색

uni* (text:uni*)
이것은 와일드 카드 검색이 아닙니다. 이 검색은 4문자 길이 문자열 "uni*"이 포함된 모든 로그 항목을 찾습니다. 로그 뷰어에서는 정규 표현식 검색이 지원되지 않으며 기본 또는 고급 로그 필터 인터페이스에는 * 또는 ?와 같은 특수 와일드카드 문자가 없습니다.
2017-02-05 (text:2017-02-05)
이것은 로그 항목 타임스탬프와 일치하지 않습니다. 이 검색은 timestamp제외한 모든 필드에서 문자열 2017-02-05가 포함된 모든 로그 항목을 찾습니다. 로그 항목의 페이로드나 다른 필드에 날짜 문자열이 포함되어 있다면 그 문자열을 검색할 수 있습니다. 검색-필터 상자 아래에 있는 이동할 날짜 메뉴를 사용할 수도 있습니다. 고급 로그 필터 인터페이스에서는 타임스탬프 범위를 지정하여 검색할 수 있습니다.
200..299 (text:200..299)
이 검색은 250과 일치하지 않습니다. 기본 로그 필터 인터페이스 검색은 8문자 길이 문자열 "200..299"가 포함된 로그 항목을 찾습니다. 이러한 범위 표기법은 정수 필드로 제한된 검색에만 허용됩니다. 특정 필드 검색을 참조하세요.
unicorn NOT phoenix (text:unicorn text:NOT text:phoenix)
unicorn OR phoenix (text:unicorn text:OR text:phoenix)
이 검색은 부울 텍스트 검색이 아닙니다. 기본 로그 필터에서는 텍스트 검색에 부울 연산자(AND, OR, NOT 또는 AND NOT) 사용을 지원하지 않기 때문입니다. 검색어를 여러 개 입력하면 단어가 암시적으로 or로 연결됩니다. 부울 NOT 연산자 대신 -(빼기) 연산자를 사용할 수 있습니다. 자세한 내용은 일반 기본 검색 예를 참조하세요.

특정 필드 검색

필드 이름을 추가하고 검색어 앞에 콜론을 추가하여 검색 대상을 특정 필드로 제한할 수 있습니다. 모든 필드 검색에서 text:는 필드 이름으로 바뀝니다. 검색-필터 상자에 입력할 때는 일치하는 필드의 목록이 표시됩니다.

기본 필드 검색{ class="screenshot" }

다음의 예에서 status:는 정수 HTTP 상태 코드이고 path:는 요청에 있는 HTTP 경로입니다.

path:query
HTTP 경로에 대소문자에 관계없이 query가 포함되어 있는 로그 항목을 찾습니다(예: /query 또는 /App/Query/17).
path:*
path 필드가 있는 로그 항목을 찾습니다. 이 경우에는 별표(*)가 특별히 사용되었습니다. 일반적으로 별표는 특수문자로 처리되지 않습니다.
status:200
상태가 (정확하게) 200인 로그 항목을 봅니다. 이 검색은 예를 들어 2000의 상태와 일치하지 않습니다. status는 정수 필드로 알려져 있기 때문에 비교가 숫자로 실행됩니다.
status:abc
잘못되었습니다. status는 정수를 포함하는 것으로 알려져 있기 때문입니다.
status:400..499
HTTP 상태가 400~499인 로그 항목을 찾습니다. 범위는 정수를 포함한 것으로 알려진 필드에만 사용할 수 있습니다. 다른 필드에 범위를 사용할 경우 그 범위는 . 문자를 포함하는 하나의 문자열로 해석됩니다.
path:query unicorn
path 필드에 query가, 그리고 모든 필드에 unicorn이 포함된 로그 항목을 찾습니다. unicorn 앞에 필드 이름이 없기 때문에 text:unicorn이라고 입력한 것과 같습니다. 여러 필드의 검색어 또는 여러 필드와 text:의 검색어를 포함하면 검색어는 암시적으로 and와 연결됩니다.
path:query path:status
path 필드에 query 또는 status가 포함된 로그 항목을 찾습니다. 동일한 필드에 여러 개의 검색어를 입력하면 단어가 암묵적으로 or로 연결됩니다.
path:query status:200 path:status status:500..502
경로에 query 또는 status가 포함되어 있으며 그리고 status 값이 200, 500, 501 또는 502인 로그 항목을 찾습니다. 즉, orand보다 결합력이 더 강하며 검색어의 순서는 중요하지 않습니다.

문제해결

기본 로그 필터 인터페이스에서 검색이 작동하지 않는 이유를 모르겠으면 고급 로그 필터 인터페이스로 잠시 전환합니다.

  1. 검색-필터 상자의 오른쪽 끝에 있는 드롭다운 화살표(▾)를 사용하여 고급 필터로 전환을 선택합니다.

  2. 검색-필터 상자가 원하는 대로 설정되어 있는지 확인합니다.

  3. 브라우저의 뒤로 버튼을 사용하여 기본 로그 필터 인터페이스로 돌아갑니다. 이 옵션을 선택하면 이전에 기본 로그 필터 인터페이스에서 선택한 항목으로 돌아갑니다.

  4. 2단계에서 필터가 잘못되어 있음을 확인한 경우 검색-필터 상자, 기본 선택기 메뉴 또는 시간-범위 선택기 메뉴에서 필터를 변경하거나 삭제할 수 있습니다.

로그 항목이 예상대로 표시되지 않는 그 밖의 이유는 다음과 같습니다.

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

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

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

이 페이지가 도움이 되었나요? 평가를 부탁드립니다.

다음에 대한 의견 보내기...

Stackdriver Logging
도움이 필요하시나요? 지원 페이지를 방문하세요.