뉴렐릭에 로그를 전송하도록 OCI 계정을 연동 하면 OCI는 데이터 소스가 되고 뉴렐릭은 대상이 됩니다. 그 중간에 뉴렐릭 함수(로그 전달자)가 OCI에서 로그를 가져와 뉴렐릭으로 전달합니다. 해당 함수에 문제(예: 읽을 수 없는 시크릿, 디코딩할 수 없는 배치 또는 완료할 수 없는 전달)가 발생하면 OCI 로그 흐름은 중단되지만, OCI나 뉴렐릭에서는 그 이유를 알려주지 않습니다.
로그 데이터 손실이 발생하기 전에 이러한 종류의 오류를 포착하기 위해 로그 전달자는 자체 상태에 대한 메트릭을 전송할 수 있습니다. 이 문서에서 다루는 내용은 다음과 같습니다:
- 로그 전달자 함수에서 자체 옵저버빌리티 메트릭을 활성화 하여 호출 횟수, 전송 오류, 파이프라인 지연과 같은 신호, 즉 파이프라인의 어느 부분에서 오류가 발생했는지 알려주는 세부 정보를 보고하도록 하십시오.
- 원시 메트릭 데이터를 일일이 확인하는 대신 이상 징후를 한눈에 파악할 수 있도록 이러한 신호를 차트로 변환하는 사전 구축된 대시보드를 가져오십시오.
전제 조건
시작하기 전에 다음 사항을 확인하십시오:
- Resource Manager, Terraform 또는 수동 설정으로 이미 배포한 OCI 로그 전달자 함수
- 대시보드를 가져올 때 사용할 뉴렐릭 계정 ID
자체 옵저버빌리티 메트릭 활성화
VAULT_REGION, SECRET_OCID 및 기타 로깅 변수를 설정한 곳과 동일한 위치인 로그 함수의 설정 변수에 다음을 추가하십시오:
FORWARDER_METRICS_TIER: 포워더가 내보내는 자체 옵저버빌리티 메트릭을 제어합니다. 각 설정이 수집하는 내용은 메트릭 티어를 참조하십시오.
Resource Manager 또는 Terraform으로 통합을 설정하는 경우 추가해야 하는 변수는 FORWARDER_METRICS_TIER 뿐입니다 — TENANCY_NAME 및 COMPARTMENT_NAME는 자동으로 처리됩니다.
통합을 수동으로 설정하는 경우 다음도 추가하십시오:
TENANCY_NAME: 표시 이름으로 OCI 테넌시를 식별하고, 포워더의 메트릭에 태그를 지정하여 둘 이상을 모니터하는 경우 테넌시를 구별할 수 있도록 합니다.COMPARTMENT_NAME: 로그 함수를 배포한 구획을 표시 이름으로 식별하여 구획별 분류를 위해 메트릭에 태그를 지정합니다. 테넌시의 루트 구획에 배포한 경우TENANCY_NAME과(와) 동일한 값을 사용하십시오.
중요
뉴렐릭은 다른 메트릭 데이터와 마찬가지로 수집 시 이러한 자체 옵저버빌리티 메트릭에 대해 요금을 청구합니다.
메트릭 티어
FORWARDER_METRICS_TIER 가시성과 비용을 절충할 수 있습니다. 다음 값 중 하나를 허용합니다:
none: 자체 옵저버빌리티 메트릭을 완전히 비활성화합니다.basic(기본값): 핵심 상태 메트릭인 호출 횟수, 수신, 전송 및 삭제된 레코드, 전송 기간, 파이프라인 지연을 수집합니다.advanced:basic의 모든 항목과 더 심층적인 튜닝 메트릭인 바이트 볼륨, 디코드 및 직렬화 오류 횟수, 일괄 처리 동작, 전송 오류 클래스, 함수 실행 기간, 시크릿 가져오기 실패, 클라이언트 캐시 히트율을 수집합니다.
옵저버빌리티 대시보드 가져오기
중요
대시보드를 가져오기 전에 FORWARDER_METRICS_TIER을(를) basic 또는 advanced (으)로 설정하십시오. none(으)로 설정하면 대시보드에 표시할 데이터가 없습니다.
대시보드를 가져오려면:
oci-log-integrationGitHub 저장소에서oci-log-forwarder-metrics-dashboard-template.json파일을 열고 내용을 복사하십시오.- 복사한 JSON에서 모든
YOUR_ACCOUNT_ID을 찾아 뉴렐릭 계정 ID로 바꾸십시오. - one.newrelic.com > All capabilities > Dashboards 으)로 이동합니다.
- 오른쪽 상단에서 Import dashboard를 클릭합니다.
- 편집한 JSON을 붙여넣으십시오.
- 대시보드의 계정 및 권한 설정을 선택한 다음 Save을(를) 클릭합니다.
메트릭이 활성화된 상태에서 로그 함수가 최소 한 번의 호출을 처리한 후에 대시보드가 채워집니다.
대시보드로 문제 해결
OCI 로그가 뉴렐릭에 더 이상 수신되지 않는 경우, 먼저 이 대시보드를 확인해 주십시오. 시크릿 페치 실패 또는 전송 오류의 급증은 OCI나 뉴렐릭 자체의 문제가 아니라 서비스 커넥터 허브, 로그 그룹 또는 함수와 같은 포워더 파이프라인의 문제를 나타냅니다. 정책 또는 키 볼트 권한과 같은 근본적인 문제를 해결한 후에는 아무것도 재배포하지 않아도 로그가 재개됩니다.
로그 데이터가 전혀 표시되지 않고 기본 통합이 작동하는지 아직 확인하지 않은 경우, 대신 표준 로그 문제 진단, 해결 절차부터 시작하십시오.
다음 단계
OCI 통합을 계속 탐색하십시오:
- 뉴렐릭이 OCI에서 수집하는 전체 메트릭 목록을 확인해 주십시오.
- 기본 통합 자체가 작동하지 않는 경우 일반적인 OCI 통합 문제 진단, 해결을 참조하십시오.