Firehose를 통한 맞춤형 통합 설정

온라인 편집

AWS 의 메트릭 스트림 CloudWatch 을 활성화하려면 통합 을 Custom setup with Firehose 적용해야 합니다. 다른 필수 구성 요소를 설정하는 방법에 대한 자세한 내용은 메트릭 스트림 설정 가이드를 참조하십시오.

통합 프로세스는 다음과 같이 구성됩니다:
  • 필수적인 AWS CloudWatch 메트릭 데이터를 제공하는 AWS 메트릭 스트림 인스턴스 설정.
  • AWS 파이어호스 전달 스트림 인스턴스를 설정하여 AWS CloudWatch 메트릭 데이터를 Instana API 로 전달합니다. 이때 사용자 정의 HTTP 엔드포인트 구성을 사용합니다.

이 섹션의 나머지 부분에서는 AWS 관리 콘솔을 사용하여 통합 프로세스를 구현하는 방법을 설명합니다.

AWS 관리 콘솔을 사용하여 AWS 메트릭 스트림을 설정합니다

AWS CloudWatch 관리 콘솔을 사용하여 AWS 메트릭 스트림 인스턴스를 설정하는 방법에 대한 자세한 내용은 AWS CloudWatch 관리 콘솔 설정 가이드를 참조하세요.

이 섹션의 나머지 부분은 Instana 을 통해 실시간에 가까운 가시성을 달성하기 위해 특별히 구성해야 하는 설정 매개변수만을 다룹니다.

표 1. 구성 매개변수
구성 매개변수 이름 구성 매개변수 필수 값
출력 형식 변경 - 선택 사항 OpenTelemetry 1.0
추가 통계 추가 - 선택 사항 현재 추가 통계는 지원되지 않으므로 기본 통계(최소값, 최대값, SampleCount, 및 합계)만 선택하십시오.
스트리밍될 메트릭스 Instana 에서 현재 지원하는 네임스페이스만 선택하십시오 Select metrics .

AWS 관리 콘솔을 사용하여 AWS Firehose 전달 스트림을 설정합니다

AWS Firehose 관리 콘솔을 사용하여 AWS Firehose 전달 스트림 인스턴스를 설정하는 방법에 대한 자세한 내용은 AWS Firehose 관리 콘솔 설정 가이드를 참조하십시오.

이 섹션의 나머지 부분은 Instana 을 통해 실시간에 가까운 가시성을 달성하기 위해 특별히 구성해야 하는 설정 매개변수만을 다룹니다.

소스 및 대상 구성

AWS Firehose 전달 스트림 데이터 전달 설정을 구성하려면 다음 매개변수를 사용하십시오:

표 2. 소스 및 대상에 대한 구성 매개변수
구성 매개변수 이름 구성 매개변수 필수 값
소스 직접 PUT
대상 HTTP 엔드포인트

대상 설정 구성

AWS 의 Firehose 전달 스트림 대상인 HTTP 엔드포인트를 구성하려면 다음 매개변수를 사용하십시오:

표 3. 대상 설정 구성 매개변수
구성 매개변수 이름 구성 매개변수 필수 값
HTTP 엔드포인트 URL

자체 호스팅용:

https://otlp-http.{base_domain}/v1/metrics/cloudwatch

SaaS 의 경우:

https://otlp-http-{region}-saas.instana.io/v1/metrics/cloudwatch
참고: region 값 및 HTTP OTLP 수신기에 대한 자세한 내용은 Instana 백엔드의 otlp-acceptor 엔드포인트를 참조하십시오.

인증 설정 구성

유효한 Instana 에이전트 키를 제공하기 위해 '액세스 키 사용' 또는 ' AWSSecrets Manager - 새구성 설정 사용' 중 하나를 선택하십시오. 이렇게 하면 Firehose 전달 스트림 요청이 Instana 엔드포인트에 대해 인증할 수 있습니다.

사용자 키 사용을 선택하는 경우:

표 4. 구성 매개변수 Use access key
구성 매개변수 이름 구성 매개변수 필수 값
접근 키 - 선택 사항 유효한 Instana 에이전트 키

새 시크릿 생성 시 ' AWS 사용'을 선택하는 경우: Secrets Manager - new

표 5. 구성 매개변수 Use AWS Secrets Manager - new
구성 매개변수 이름 구성 매개변수 필수 값
시크릿 유형 기타 유형
키-값 쌍

비밀 키: api_key

비밀값: 유효한 Instana 에이전트 키

콘텐츠 인코딩 설정 구성

목적지로 전송하기 전에 요청 본문을 압축하도록 GZIP 선택하십시오. Instana 에서 데이터를 처리하고 전체 데이터 전송 비용을 통제하기 위해서는 encoding GZIP 사용이 필수적입니다.

재시도 기간 설정 구성

실시간에 가까운 데이터 처리를 달성하려면 재시도 기간이 짧아야 합니다. 짧은 재시도 기간은 지연된 데이터 포인트가 실시간 데이터 분석( Instana ) 시계열 그래프에서 데이터 연속성을 방해하지 않도록 보장합니다.

표 6. 재시도 기간에 대한 구성 설정
구성 매개변수 이름 구성 매개변수 필수 값
재시도 지속 기간 60초
참고:
  • Instana 기간이 Retry duration 만료된 후 AWS S3 버킷에 백업된 CloudWatch 데이터를 처리하지 않습니다.
  • AWS Firehose는 재시도 후 전송 순서를 보장하지 않으며, 재시도된 데이터와 새 데이터는 무작위 순서로 도착할 수 있습니다.

버퍼 힌트 설정 구성

AWS 데이터 파이어호스는 구성된 데이터 크기( 버퍼 크기 )와 시간 간격( 버퍼 간격 )에 따라 CloudWatch 메트릭을 메모리에 버퍼링한 후 지정된 목적지로 데이터를 전달합니다. Instana 에서 실시간에 가까운 관측 가능성 데이터 처리를 달성하려면, 버퍼 크기 (Buffer size) 및 버퍼 간격(Buffer interval) 매개변수 값을 낮은 임계값으로 설정하여 데이터가 가능한 한 신속하게 InstanaAPI 로 전송되도록 합니다.

표 7. 버퍼 힌트 구성 설정
구성 매개변수 이름 구성 매개변수 필수 값
버퍼 크기 1 MiB
버퍼 간격 60초
참고:
  • 주어진 버퍼 힌트 구성으로, 선택된 CloudWatch 네임스페이스에 활성 메트릭 업데이트가 있는 경우 예상 지연 시간은 3분 이내입니다.
  • CloudWatch 메트릭 스트림에서는 데이터가 매분 전송되며, 최종 목적지에 순서대로 도착하지 않을 수 있습니다. 지정된 네임스페이스에 구성된 모든 메트릭은 메트릭 스트림으로 전송됩니다. 단, 타임스탬프가 2일 이상 지난 메트릭은 제외됩니다.