Envoy 로그

Envoy 로그를 HTTPS를 통해 Panther로 직접 스트리밍

개요

Panther는 수집을 지원합니다 Envoy 액세스 로그를 스트리밍하여 하나의 HTTP 소스를 통해 전달된 후, Fluent Bit.

Envoy 로그를 Panther에 온보딩하는 방법

1단계: Panther에 새 Envoy 로그 소스 만들기

1. Panther Console의 왼쪽 탐색 모음에서 클릭 로그 소스.

2. 클릭합니다 새로 만들기.

3. "Envoy"를 검색한 다음 해당 타일을 클릭하세요.

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

4. 클릭합니다 설정 시작.

5. Panther의 HTTP 소스 구성 지침을 따르세요, 5단계부터 시작합니다.

   • 설정할 때 인증 방식 소스에는 다음 사용을 권장합니다 공유 비밀. 헤더 이름과 값을 안전한 위치에 저장하세요. 3단계에서 필요합니다.

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

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

2단계: Envoy 로깅 구성

Envoy 로그에 필드를 추가하거나 제거하여 사용자 지정할 수는 있지만, Panther의 Envoy.Access 스키마 는 기본 로그 형식을 지원하도록 설계되었습니다. 분류 실패를 방지하려면 로그 구성에는 기본 형식을 사용하세요.

1. 다음 항목을 추가하세요 envoy.yml 구성 파일:

   • 루트 수준에서 관리자 액세스 로깅을 활성화하려면 다음 스니펫을 추가하세요:

     admin:
       access_log_path: "access.log"

   • 리소스 섹션에서 액세스 로깅을 활성화하려는 각 리소스에 다음 스니펫을 추가하세요:

      access_log:
      - name: envoy.access_loggers.file
        typed_config:
          "@type": type.googleapis.com/envoy.extensions.access_loggers.file.v3.FileAccessLog
          path: "access.log"

액세스 로그 파일 경로(access.log 위에), Fluent Bit 구성에서도 적절한 위치를 가리키도록 하세요.

1. 업데이트된 구성 파일을 가리키도록 Envoy 프록시를 다시 시작하려면 다음을 실행하세요 envoy -c envoy.yml.

3단계: Fluent Bit 구성

1. 다음을 따르세요. Fluent Bit 시작하기 안내 Fluent Bit을 서비스로 설치합니다.

2. 다음을 생성합니다 Fluent Bit 구성 파일, 그리고 다음 필드를 설정하세요:

   • [INPUT] 변수:

     • 이름: 다음으로 설정 tail.

     • 경로: 로그 파일 경로로 설정하세요.

     • 파서: 다음으로 설정 envoy.

   • [OUTPUT] 변수:

     • 호스트: Panther URL을 입력합니다.

       • 예: logs.instance-name.runpanther.net

     • URI: 이 프로세스의 1단계에서 생성된 HTTP Source 수집 URL의 끝부분을 다음으로 시작하는 값으로 입력합니다 /http/.

       • 예: /http/cb015ee4-543c-4489-9f4b-testaa16d7a

     • 헤더: 1단계에서 Panther Console의 HTTP 소스를 구성할 때 생성한 헤더 이름과 생성한 비밀값을 입력합니다.

     • Format: 다음으로 설정 json_lines

     • 이름: 다음으로 설정 http.

     • TLS: 다음으로 설정 켜기.

     • 포트: 다음으로 설정 443.

   [SERVICE]
       Flush      1
   [INPUT]
       Name       tail
       # 이 경로는 envoy.yml 구성에 따라 다릅니다
       경로       /var/log/envoy/access.log
       파서     envoy
   
   [OUTPUT]
       Name       http
       Match      *
       호스트       logs.pre-alpha.runpanther.net
       Port       443
       URI        /http/6897ec53-9c4c-4fc7-a8c8-faf7b29571de
       # x-sender-header 이름이 헤더 이름과 일치하는지 확인하세요
       # Panther에서 HTTP 소스를 만들 때 제공한
       Header     x-sender-header {YOUR_SECRET_HERE}
       Format     json_lines
       TLS        On
       TLS.Verify On

3. 새 구성 파일 경로와 parsers.conf 파일 경로를 전달하여 Fluent Bit을 시작하세요. 이 envoy 파서는 Fluent Bit에 포함된 기본 파서 구성에서 사용할 수 있습니다.

   • 예: fluent-bit -c fluent.conf -R /var/etc/fluent-bit/parsers.conf

지원되는 로그 유형

Envoy.Access

다음은 Envoy 액세스 로그 스키마를 정의합니다:

스키마: Envoy.Access
설명: FluentBit을 사용한 HTTP 기반 Envoy 액세스 로그
필드:
  - 이름: start_time
    설명: 요청 시작 시간.
    유형: timestamp
    시간 형식:
      - rfc3339
    이벤트 시간 여부: true
  - 이름: method
    설명: GET, POST 등과 같은 HTTP 요청 메서드.
    유형: string
  - 이름: path
    설명: 요청의 URI 경로.
    유형: string
  - 이름: protocol
    설명: HTTP 프로토콜 버전.
    유형: string
  - 이름: code
    설명: 응답의 HTTP 상태 코드.
    유형: string
  - 이름: response_flags
    설명: 응답과 관련된 추가 플래그.
    유형: string
  - 이름: bytes_received
    설명: 클라이언트로부터 수신된 바이트 수.
    유형: string
  - 이름: bytes_sent
    설명: 클라이언트로 전송된 바이트 수.
    유형: string
  - 이름: duration
    설명: 요청의 총 소요 시간.
    유형: string
  - 이름: x_envoy_upstream_service_time
    설명: 업스트림 서비스에서 소요된 시간.
    유형: string
  - 이름: x_forwarded_for
    설명: X-Forwarded-For 헤더(있는 경우).
    유형: string
  - 이름: user_agent
    설명: 요청 헤더의 User-Agent 문자열.
    유형: string
  - 이름: request_id
    설명: 요청 ID 헤더 값.
    유형: string
  - 이름: authority
    설명: authority 헤더 값.
    유형: string
  - 이름: upstream_host
    설명: 요청에 대해 선택된 업스트림 호스트.
    유형: string