Heroku 로그

Panther는 webhook을 통해 Heroku 로그를 직접 수신하는 것을 지원합니다

개요

Panther는 수집합니다 Heroku 런타임 로그 구성하여 Heroku 로그 드레인 이벤트를 Panther에 게시하려면 HTTP 소스.

Heroku 런타임 로그를 Panther에 온보딩하는 방법

전제 조건

• 이 프로세스의 2단계(Heroku에서 로그 드레인 생성)를 완료하려면 Heroku의 CLI가 설치되어 있어야 합니다. 아직 설치되어 있지 않다면 다음을 따르세요 Heroku 문서에서 여기에 설치하는 방법.

1단계: Panther에서 새 Heroku 소스 생성

1. Panther 콘솔의 왼쪽 탐색 바에서 클릭하세요 구성 > 로그 소스.

2. 클릭 새로 만들기.

3. “Heroku”를 검색한 다음 해당 타일을 클릭합니다.

   • 슬라이드아웃 패널에서 전송 메커니즘 오른쪽 상단의 드롭다운은 미리 채워져 있습니다 HTTP 옵션.

4. 클릭 설정 시작.\

   
5. 다음을 따르십시오 Panther의 HTTP 소스 구성 지침.

   • 이 로그 소스를 처음 설정할 때 인증 방법 를 매개변수 를 받습니다. 기대한 위치에 키가 없거나 해당 위치의 값이로 설정하세요. 아래 3단계에서 Heroku에서 인증 토큰을 가져온 후 이를 Shared Secret 인증으로 변경할 것입니다.

   • 이 소스로 전송되는 페이로드는 모든 HTTP 소스에 대한 페이로드 요구사항.

   • HTTP 엔드포인트 생성이 완료될 때까지 다음 단계로 진행하지 마세요.

2단계: Heroku에서 새 로그 드레인 생성

이 단계를 시작하기 전에 전제 조건 이 충족되었는지 확인하세요.

1. Heroku CLI에서 맞춤형 버전의 다음 명령을 실행하여 Heroku 앱에서 Panther의 HTTP 소스로 가리키는 로그 드레인을 설정하세요: heroku drains:add https://logs.mypantherdomain.runpanther.net/http/1081f021-a983-4dae-bcbb-1952ffaa4e72 -a myherokuappname

2. 다음 명령을 실행하여 드레인 토큰을 가져오세요: heroku drains --json -a myherokuappname

   • 이 명령의 출력에서 token의 값을 저장하세요. 다음 단계에서 사용됩니다.

3단계: Panther에서 로그 소스 보안 설정

1. Panther 콘솔로 다시 이동하세요.

2. 1단계에서 생성한 로그 소스를 찾으려면 구성 > 로그 소스을 클릭하고 소스 이름을 클릭하세요.

3. 오른쪽 상단에서 클릭하십시오 구성그런 다음 편집을 클릭하고.

4. 오른쪽 상단에서 보안 탭을 클릭하십시오.

5. 의 값을 변경하세요 인증 방법 드롭다운을 공유 비밀(Shared Secret)로 변경한 다음 다음 필드에 대한 값을 입력하세요:

   • 헤더 이름포트 Logplex-Drain-Token.

   • 공유 비밀 값: 앞서 Heroku CLI에서 가져온 token 을 여기에 붙여넣으세요.

6. 클릭 저장.

지원되는 로그 유형

Heroku.Runtime

Heroku.Runtime 로그는 앱, 시스템, API 및 애드온 로그를 포함하는 Heroku의 이벤트 로그입니다. 자세한 내용은 Heroku의 런타임 로그에 대한 문서를 참조하세요.

스키마: Heroku.Runtime
파서:
  fastmatch:
    match:
      - '%{message_len} <%{priority}>%{version} %{timestamp} %{host_name} %{app_name} %{process_id} %{message_id} %{message}'
    emptyValues:
      - '-'
설명: 애플리케이션 자체에서 출력되는 로깅으로, 앱의 코드와 종속성이 생성한 로그뿐만 아니라 시스템 및 API 로그를 포함합니다.
참고 URL: https://devcenter.heroku.com/articles/logging#runtime-logs
필드:
  - 이름: message_len
    유형: int
  - 이름: priority
    유형: int
  - name: version
    type: string
  - 이름: timestamp
    type: timestamp
    timeFormats:
      - rfc3339
    isEventTime: true
  - 이름: host_name
    type: string
    지표:
      - 호스트명
  - 이름: app_name
    type: string
  - 이름: process_id
    type: string
  - 이름: message_id
    type: string
  - name: message
    type: string