OCI 로그 포워딩 통합은 오라클 클라우드 인프라(Oracle Cloud Infrastructure, OCI) 테넌시의 로그를 뉴렐릭으로 전송합니다. 뉴렐릭은 시간이 지남에 따라 기능을 추가하고, 문제를 해결하며, 보안 업데이트를 제공하는 새로운 버전의 통합을 출시합니다. 로그가 더 이상 수신되지 않거나 기존 통합에 다른 문제가 발생하는 경우, 최신 버전에 해결책이 포함되어 있을 수 있습니다. 통합은 자체 테넌시에서 실행되므로, 배포한 항목을 업그레이드하여 새 버전을 수신할 수 있습니다. 이 가이드에서는 해당 프로세스를 안내합니다:
- 어떤 설정을 사용 중인지 확인하십시오.
- 필요한 경우 이전 설정에서 현재 설정으로 이동하십시오.
- Resource Manager, Terraform 또는 수동 설정을 사용하여 업그레이드하십시오.
- 로그가 계속 도착하는지 확인하십시오.
처음으로 포워딩을 설정하려면 OCI 로그 포워딩 설치 및 설정을 참조하십시오.
업그레이드 시기
로그가 전송되는 동안에는 업그레이드할 필요가 없습니다. oci-log-integration 릴리스 페이지에서 각 새 버전의 릴리스 노트를 읽고 해당 릴리스가 중요한지 결정하십시오. 조치를 취해야 할 수도 있으므로, 특히 호환성이 손상되는 변경 사항이 있는지 확인하십시오.
설정 확인
배포는 두 가지 설정 중 하나를 사용합니다. Resource Manager 스택 또는 Terraform 모듈의 설정을 확인하십시오:
- Function image [함수 이미지] 설정이 있는 Current setup [현재 설정]: 적용 시 통합은 도커 허브에서 자체 테넌시의 프라이빗 컨테이너 레지스트리 저장소로 함수 이미지를 복사하며, 함수는 해당 복사본에서 실행됩니다. 런타임에 함수가 뉴렐릭 호스팅 레지스트리에 의존하지 않으므로, 함수의 가용성은 해당 레지스트리에 얽매이지 않습니다. 통합은 적용 중에만 도커 허브를 사용합니다. 버전을 고정할 수 있습니다.
- 이전 설정(New Relic Owned Registry [뉴렐릭 소유 레지스트리] 설정 사용): 함수는 자체 테넌시의 사본에서 가져오는 대신, 설정한 버전의 뉴렐릭 소유 레지스트리에서 직접 가져옵니다. 뉴렐릭은 이 설정을 사용 중단했습니다.
이전 설정을 사용 중인 경우, 먼저 현재 설정으로 일회성 이동을 수행해 주십시오. 그 이후에는 모든 업그레이드가 일반 업그레이드 단계를 따릅니다.
함수 및 템플릿 이해
통합은 두 부분으로 구성됩니다. 각각 독립적으로 버전이 지정되고 릴리스되며, 릴리스 시 둘 중 하나 또는 둘 다 변경될 수 있습니다:
- 로그 전달자 함수: 뉴렐릭으로 로그를 전송하는 코드입니다. 뉴렐릭은 이를 도커 허브에
docker.io/newrelic/oci-log-forwarder(으)로 게시하고, oci-log-integration 릴리스 페이지에서 각 릴리스의 이름을function-<version>(으)로 지정합니다. - 통합 템플릿: 리소스 관리자 스택 및 변수 또는 Terraform 모듈에 해당하는 함수 관련 설정입니다. 템플릿 릴리스는 동일한 릴리스 페이지에서 일반 버전 번호를 사용하며
oci-log-integration.zip파일을 포함합니다. Terraform 모듈 버전은terraform-provider-newrelic릴리스 태그입니다.
각 부분이 업데이트되는 방식은 사용 방법에 따라 다릅니다:
- Resource Manager 및 Terraform이 기능을 새로 고칩니다. 적용할 때마다 도커 허브에서
latest태그가 가리키는 이미지를 확인하고 더 최신 이미지를 가져옵니다. - 최신 템플릿 적용은 신중히 진행해야 하는 단계입니다. 릴리스에서 템플릿이 변경된 경우에만 템플릿을 업데이트하고, 함수도 동시에 업데이트하십시오. 이렇게 하면 배포가 뉴렐릭에서 해당 릴리스에 대해 테스트한 조합으로 유지됩니다. 함수 릴리스는 이미 사용 중인 템플릿과 호환되므로, 최신 템플릿보다 최신 함수를 먼저 적용할 수 있습니다.
- 수동 설정은 아무것도 자동으로 업데이트하지 않습니다. 직접 버전을 선택하고 이미지를 복사해야 합니다.
시작하기 전에
업그레이드하기 전에:
- 통합을 실행하는 리소스 관리자 스택, Terraform 설정 또는 Functions 애플리케이션을 편집할 수 있는지 확인하십시오.
- 현재 실행 중인 버전을 확인하고 최신 릴리스와 비교하십시오: Function image [함수 이미지] 값 또는 이미지 태그, 그리고 Terraform 모듈의
?ref=값.
이전 설정에서 현재 설정으로 이동
이는 일회성 마이그레이션으로, 버전 업그레이드가 아닙니다.
변경 사항. 설정에 전체 이미지 참조가 포함된 Function image [함수 이미지] 설정과 선택 사항인 Container Registry [컨테이너 레지스트리] username [사용자 이름] 및 auth token [인증 토큰] 설정이 추가됩니다. 뉴렐릭은 New Relic Owned Registry [뉴렐릭 소유 레지스트리] 지원을 종료했으며, 이는 아무런 영향을 미치지 않습니다. 첫 번째 적용 시, 통합은 newrelic-logs/oci-log-forwarder (Terraform의 경우 newrelic-logs-tf/oci-log-forwarder)(이)라는 이름의 비공개 Container Registry [컨테이너 레지스트리] 저장소를 생성하고 그 안에 함수 이미지를 복사합니다.
가장 먼저 확인해야 할 사항입니다. apply를 실행하는 요소는 이미 도달하는 OCI 엔드포인트 외에도 도커 허브 및 사용자 테넌시의 컨테이너 레지스트리에 대한 아웃바운드 액세스가 필요합니다. 또한 통합에서 이미지를 푸시하려면 컨테이너 레지스트리 자격 증명이 필요합니다. auth token [인증 토큰] 설정을 비워 두면 apply를 실행하는 사용자를 위해 토큰이 생성되며 이후 apply에서 이를 재사용합니다.
중요
OCI는 각 사용자가 보유할 수 있는 auth token [인증 토큰]의 수를 제한하며, 현재 그 수는 두 개입니다. 적용을 실행하는 사용자가 이미 최대 개수를 보유하고 있고 auth token [인증 토큰] 설정을 비워 두면, 기존 토큰을 요청하는 오류와 함께 적용이 실패합니다. 먼저 사용하지 않는 토큰을 삭제하거나, auth token [인증 토큰] 및 username [사용자 이름] 설정에 기존 토큰과 해당 사용자 이름을 입력하십시오. OCI User Settings [사용자 설정]에서 현재 제한을 확인하십시오.
현재 설정에서 배포를 업그레이드하십시오.
스택 또는 모듈에 Function image [함수 이미지] 설정이 있는 경우 다음 단계를 따르십시오. 통합을 설정하는 데 사용한 방법을 선택하십시오.
업그레이드 후 확인
업그레이드 후 몇 분 이내에 로그가 계속 도착하는지 확인하십시오:
SELECT count(*) FROM Log WHERE instrumentation.provider = 'oci' SINCE 10 minutes ago카운트가 0으로 떨어지면 OCI Console [OCI 콘솔]에서 함수의 실행 로그를 확인하십시오.
업그레이드 후 첫 번째 호출 시 함수가 새 이미지를 가져오는 동안 일시적으로 느려지는 것은 정상입니다. 어떤 버전이 적용되었는지 확인하려면 컨테이너 레지스트리 저장소에서 이미지 태그를 확인하십시오.
관련 기사
- OCI 로그 포워딩 설치 및 설정: 처음으로 OCI 로그 포워딩을 설정합니다.
- OCI 로그 전달자 모니터: 로그 전달자 함수에서 자체 옵저버빌리티 메트릭을 활성화하십시오.
- 문제 진단, 해결: 설정 중 데이터가 표시되지 않는 문제에 대한 해결 방법입니다.