범용 HTTP sink로 HCP Vault Dedicated 메트릭 스트리밍 구성하기

범용 HTTP sink로 HCP Vault Dedicated 메트릭 스트리밍 구성하기

네이티브 통합을 아직 사용할 수 없을 때 사용할 수 있는 선택적 메트릭 스트리밍 구성인 범용 HTTP sink(Generic HTTP Sink)로 HCP Vault Dedicated 메트릭을 전송하는 방법을 설명하는 페이지예요. 메트릭 범위와 해석에 대한 자세한 내용은 HCP Vault Dedicated 메트릭 문서를 참고해 주세요.

출처: 문서

본문

가용성

HCP Vault Dedicated 메트릭 스트리밍은 모든 프로덕션급 클러스터에서 사용할 수 있어요. 이 기능은 Development 티어 클러스터에서는 사용할 수 없어요.

범용 HTTP sink는 네이티브 통합을 아직 사용할 수 없을 때 사용할 수 있는 선택적 메트릭 스트리밍 구성이에요. 메트릭을 JSON 또는 NDJSON 형식으로 보내는 것을 지원해요. 또한 텔레메트리 서비스가 지원한다면 메트릭을 압축(gzip)하도록 선택할 수 있어요. 범용 HTTP sink의 정확한 구성은 대상 텔레메트리 서비스에 따라 달라져요. 모든 텔레메트리 서비스가 범용 HTTP sink 사용을 지원하지는 않아요.

네이티브 지원 제공자의 전체 목록은 HCP Vault Dedicated 통합 문서를 참고해 주세요.

사전 요구 사항

감사 로그 스트리밍을 구성하려면 다음이 필요해요.

  • 역할이 할당된 Admin 권한을 가진 HCP 계정
  • essentials 또는 standard 티어 HCP Vault Dedicated 클러스터

참고

실행 중인 클러스터가 없다면 HCP에서 Vault 클러스터 만들기 또는 Terraform으로 HCP Vault Dedicated 배포 튜토리얼을 참고해 HCP Vault Dedicated 클러스터를 만들어 주세요.

대상 메트릭 서비스 구성

예제 로그 집계 서비스

Webhook.site는 데모 목적으로 사용되며, 첫 접근 시 고유한 URL을 생성해요.

기존 HCP Vault Dedicated 클러스터를 사용 중이라면 메트릭이 공개적으로 사용 가능해져요.

  1. 웹 브라우저를 열고 https://webhook.site/로 이동해요.
  2. 생성된 URL을 기록해 두세요.
  3. 이 페이지를 열어 두세요. HCP Vault Dedicated를 구성할 때 이 사이트로 돌아오게 돼요.

메트릭 스트리밍 활성화

  1. 새 웹 브라우저/탭을 열고 HCP Portal에 로그인해요.
  2. Vault clusters 페이지로 이동해요.
  3. 스트리밍을 활성화할 Vault 클러스터를 클릭하고 Metrics를 클릭해요.
  4. Enable metric streaming을 클릭해요.
  5. Select a provider 화면에서 제공자로 Generic HTTP Sink를 선택하고 Next를 클릭해요.
  6. Add provider details 아래의 URI 필드에 webhook.site의 Your unique URL을 입력해요.
  7. Strategy 풀다운 메뉴를 클릭해요. 범용 HTTP sink는 Basic(사용자 이름과 비밀번호) 또는 Bearer(토큰) 인증을 모두 지원해요.
  8. Strategy 메뉴를 비워 두세요 - webhook.site에는 필요하지 않아요.
  9. Headers (Optional) 필드를 비워 두세요. 요청에 키/값 쌍으로 추가 헤더를 추가할 수 있어요.
  10. Compression 아래에서 Disable을 선택해요. 압축은 로깅 서비스로 보내는 로그를 gzip할지 선택하게 해 줘요. 로깅 서비스가 gzip 로그 스트리밍을 지원하는지 확인해 주세요.
  11. Encoding codec 풀다운 메뉴를 클릭하고 JSON을 선택해요. 범용 HTTP sink는 JSON과 NDJSON을 모두 지원해요. JSON을 사용하면 전체 메시지가 단일 JSON 배열로 전송돼요. NDJSON을 사용하면 각 요소가 새 줄에 배치되고 대괄호([])로 감싸지 않아요.
  12. Payload prefix와 Payload suffix를 비워 두세요. 선택적 접두사와 접미사는 메시지에 사용자 지정 접두사·접미사를 추가하게 해 주며, JSON 형식이어야 해요.
  13. Save를 클릭해요.
  14. HCP Portal에서 메트릭 스트리밍을 활성화하는 절차는 최대 20분이 걸릴 수 있지만, 메트릭은 몇 분 후에 나타나기 시작해요.

참고

현재 HCP Vault Dedicated는 한 번에 하나의 엔드포인트로의 메트릭 스트리밍만 지원해요.

메트릭 스트리밍 구성 편집 (선택)

메트릭 스트리밍 통합을 편집하려면 다음 단계를 수행해 주세요.

  1. Metrics 페이지에서 Manage 드롭다운을 클릭한 다음 Edit configuration을 클릭해요.
  2. 구성을 편집한 다음 Save를 클릭해요.

메트릭 스트리밍 비활성화 (선택)

메트릭 스트리밍 통합을 비활성화하려면 Metrics 페이지에서 Manage 드롭다운을 클릭한 다음 Disable streaming을 클릭해 주세요.

더 알아보기 (Learn more)