시그널 선택
실패 조사는 이슈나 로그에서 시작하세요. 실행 1회를 살펴보려면 사용할 수 있는 트레이스를 여세요. 더 넓은 기간을 살펴보려면 메트릭 추세를 보세요. 활동과 재방문은 제품 분석을 참고하세요.
조사에 필요한 필드만 수집하세요. 서비스, 작업, 메트릭 이름은 바뀌지 않게 정하세요. 자격 증명, 결제 데이터, 가공하지 않은 요청 본문은 보내지 마세요. 수집 데이터를 제어하는 방법은 수집 데이터 관리하기 문서에 있습니다.
로그
로그는 애플리케이션이 특정 시점에 남긴 기록입니다. 유용한 로그에는 다음이 들어 있습니다.- 이벤트의 발생 시각
- 표준 심각도
- 프로젝트와 서비스 범위
- 환경과 릴리스
- 로그에 활성 트레이스 컨텍스트가 있으면 트레이스와 스팬 식별자
- 이벤트 컨텍스트를 담은, 이름이 붙은 작은 속성
occurred_at, severity, project_id, service_name, environment, release, trace_id, span_id, attributes에 들어 있습니다. 컨텍스트는 메시지 텍스트가 아니라 이름이 붙은 속성에 넣으세요.
여러 서비스의 로그가 한 화면에 함께 보여도 트레이스 관계가 있는 것은 아닙니다. 트레이스 관계는 트레이스 컨텍스트로만 생깁니다.
트레이스
트레이스는 요청이나 작업 1건의 스팬으로 이루어집니다. 루트 스팬에는 부모가 없습니다. 자식 스팬은 자신의 부모를 가리킵니다. 한 트레이스의 모든 스팬은 트레이스 ID가 같고 스팬 ID는 서로 다릅니다. 분산 트레이싱을 참고하세요. 활성 트레이스 컨텍스트 없이 보낸 로그, 이슈, 액션, 메트릭에는 수집 트레이스가 붙습니다. 이 트레이스에는 수집 스팬만 들어 있습니다. 요청 경로를 보여 주지는 않습니다. 수집 스팬을 참고하세요.메트릭
메트릭은 시간에 따라 측정한 값을 기록합니다. 메트릭은 항상 이름, 단위, 차원, 프로젝트, 기간, 간격과 함께 읽으세요. LogBrew는 메트릭의kind와 temporality에 따라 각 데이터 포인트의 value를 정합니다.
예를 들어 한 간격에 값이
2, 3, 5인 delta 카운터 샘플 3개가 있으면 데이터 포인트의 value는 10, sample_count는 3입니다. 같은 값을 같은 순서로 가진 게이지 샘플 3개라면 value는 5입니다. p95 값은 평균이 아닙니다. 기록된 관측값의 약 95%가 이 값 이하입니다.
status: "ready"이면 계산된 집계를 쓸 수 있습니다. status: "limited"이면 aggregation.limitation을 읽고 원시 값만 사용하세요. 게이지나 누적 스트림은 합산하지 마세요. 데이터 포인트가 없는 간격은 측정값 0이 아닙니다. 쿼리 필드는 쿼리 필터를 참고하세요.
GET /api/telemetry/metrics/series가 이 데이터 포인트를 반환합니다. 이 요청에는 project_id, name, since가 필요합니다. 각 시계열에는 kind, unit, temporality로 이루어진 identity가 1개 있습니다. identity가 다른 시계열은 따로 유지됩니다. 각 데이터 포인트에는 다음 필드도 들어갈 수 있습니다.
series_limit 때문에 양이 적은 시계열이 빠지면 coverage.truncated가 true입니다. 메트릭 기간을 같은 길이의 직전 기간과 비교하려면 다음을 실행하세요.
이슈
이슈는 반복되는 실패를 안정적인 핑거프린트로 묶습니다. 이슈에는 심각도, 상태, 발생 횟수, 최초 발생 시각, 마지막 발생 시각이 있습니다. 이슈 상세 정보에는 예외 체인, 스택 프레임, 브레드크럼, 관련 로그, 트레이스 관계가 추가될 수 있습니다.last_seen_at은 그룹에서 가장 최근 발생 건의 시각입니다. 선택한 발생 건은 이보다 오래되었을 수 있습니다. 두 시각을 모두 확인하세요.
이슈의 status는 unresolved, resolved, archived 중 하나입니다. API 응답 버전 1에서는 archived가 ignored로 표시됩니다. 응답 버전 2와 3에는 priority(high, medium, low)와 priority_source가 추가됩니다. 버전 3에는 assignee도 추가됩니다. 상태 값과 우선순위를 참고하세요.
액션
액션은 제품 활동을 기록합니다. 지원되는 분류에 따라 액션은 페이지 조회, 화면 조회, 상호작용 중 하나로 표시됩니다. 이벤트 이름만으로는 분류가 정해지지 않습니다. 이 컨텍스트를 추가하려면 제품 이벤트 수집을 참고하세요. 세션은 사용자가 아닙니다. 익명 주체는 식별된 사용자가 아닙니다.심각도 값
LogBrew는 별칭을 대소문자 구분 없이 입력으로 받습니다. API, CLI, 실시간 이벤트는 표준 값을 사용합니다. 알 수 없는 심각도 값은 거부됩니다. 심각도는 기록된 긴급도입니다. 비즈니스 영향이나 근본 원인을 나타내지 않습니다.
사용자는 이슈나 로그에 표시되는 심각도를 바꿀 수 있습니다. 그러면 응답에
effective_severity가 담긴 triage 객체가 들어갑니다. severity 필드에는 수집된 원래 값이 남습니다.
실시간 조회와 스냅샷 조회
logbrew read는 선택한 프로젝트, 기간, 필터의 스냅샷을 반환합니다. 새 이벤트를 읽으려면 다시 실행하세요. logbrew watch는 연결이 열려 있는 동안 새 로그, 이슈, 액션을 스트리밍합니다. 트레이스와 메트릭은 스트리밍하지 않습니다. 연결에 실패했다고 해서 프로젝트가 비어 있다는 뜻은 아닙니다.
근거 상태
응답은 수집됨, 수집 안 됨, 가려짐, 잘림, 사용할 수 없음 상태를 서로 구분합니다. 트레이스 근거의 상태는available, not_linked, not_found, unavailable 4가지입니다. 각 상태의 의미는 개요를, 커버리지 필드는 근거의 한계를 참고하세요. SDK를 새 버전으로 올려도 이전에 보낸 이벤트에 필드가 추가되지는 않습니다.
프로젝트 1개 조사하기
1
미해결 이슈 찾기
2
이슈 1개 읽기
이 명령어는 보존된 이슈 이력을 읽습니다. 목록 조회에 쓴
--since 필터는 적용되지 않습니다.3
사용할 수 있는 트레이스 열기
선택한 발생 건이 트레이스 ID를 반환할 때만 그 ID를 사용하세요.
4
관련 근거 읽기
같은 프로젝트, 서비스, 환경, 릴리스로 로그, 액션, 메트릭을 필터링하세요. 시간만으로 시그널을 연결하지 마세요.