Azure Go 용 컨테이너 앱 추적
Azure Container Apps에 배포된 Go 애플리케이션에 대해서는 Instana Go 의 인프로세스 수집기를 사용하여 추적 기능을 설정할 수 있습니다. Go 인-프로세스 수집기를 사용하려면, 애플리케이션에 Instana Go Tracer SDK를 적용하고, 이를 Azure Container Apps에 배포한 다음, 필요한 환경 변수가 설정되어 있는지 확인하십시오.
지원되는 런타임
Instana Go in-process 수집기는 Go 1.21 및 이후 버전을 지원합니다.
제한사항
현재 Instana 은 Azure 컨테이너 앱의 인프라 메트릭 수집을 지원하지 않습니다.
Go 용 Azure 컨테이너 앱 추적 설정
Go 용 Azure 컨테이너 앱 추적을 설정하려면 다음 섹션을 참조하십시오
전제조건
Go 인프로세스 수집기 모듈의 최신 버전을 사용해야 합니다. Go 인프로세스 수집기 모듈의 최신 버전을 사용하고 있는지 확인하려면 프로젝트 내의 파일을 go.mod 확인하거나 다음 명령을 실행하십시오:
go get github.com/instana/go-sensor@latest
최신 버전의 Go 인프로세스 수집기가 설치되어 있지 않다면, 최신 버전을 다운로드하여 해당 go.mod 파일에서 필요한 버전을 업데이트하십시오. 자세한 내용은 Go 설치 안내를 참조하십시오.
Azure 컨테이너 앱 구성
Instana Go 1.63.0 의 인-프로세스 수집기는 Azure 에이전트에서 Azure 컨테이너 앱을 지원합니다. Go 애플리케이션에 Instana Go Tracer SDK를 적용하면, Instana Go 인프로세스 수집기가 서버리스 모드로 전환됩니다. 수집된 스팬을 호스트 에이전트로 전송하는 대신, 수집기는 이를 환경 변수를 INSTANA_ENDPOINT_URL 통해 구성된 Instana 서버리스 수신 엔드포인트로 직접 제출합니다.
이 프로세스는 환경 INSTANA_AGENT_KEY 변수에 정의된 에이전트 키를 사용합니다. Azure 컨테이너 앱의 리소스 ID는 인프라 상관을 위한 엔티티 ID로 사용됩니다. 리소스 ID를 생성하려면 환경 변수 AZURE_SUBSCRIPTION_ID 와 를 AZURE_RESOURCE_GROUP 설정해야 합니다.
수집된 스팬을 Instana 백엔드로 전송하려면, Azure 컨테이너 앱에서 다음 환경 변수를 설정하십시오:
INSTANA_ENDPOINT_URL: Instana 백엔드 엔드포인트 의 ` URL `를 설정하세요.INSTANA_AGENT_KEY: 에이전트 키 로 설정하십시오.INSTANA_TIMEOUT: 구성한 영역에 따라 적절한 타임아웃 값을 설정하십시오.
인프라 상관의 경우 다음 환경 변수를 설정하십시오.
AZURE_SUBSCRIPTION_ID: Azure 구독 ID 로 설정하세요.AZURE_RESOURCE_GROUP: 리소스 그룹을Azure 로 설정하십시오.
추적 사용
Azure Container Apps에서 Go 애플리케이션의 추적 기능을 활성화하려면 다음 단계를 수행하십시오:
Instana Go Tracer SDK를 다운로드한 후, 다운로드한 SDK를 사용하여 애플리케이션에 추적 기능을 추가하십시오.
애플리케이션의 컨테이너 이미지를 작성하십시오.
컨테이너 이미지를 Azure 컨테이너 앱에 배치하십시오.
참고: 이미지를 배포하기 전에, ‘ Azure ’의 컨테이너 앱에서 필요한 환경 변수가 설정되어 있는지 확인하십시오. 자세한 내용은 ‘ Azure 컨테이너 앱 구성’을 참조하십시오.
이제 Instana UI에서 Go 애플리케이션의 추적 정보를 확인할 수 있습니다.
예
. gin으로 작성된 웹 서버가 있다고 가정해 봅시다. 추적 기능을 활성화하려면 Instana Go Tracer github.com/instana/go-sensor/tree/main/instrumentation/instagin SDK를 사용하여 애플리케이션에 추적 코드를 삽입하십시오. 그런 다음, 애플리케이션의 컨테이너 이미지를 생성하고 Azure Container Apps에 배포하세요. 이미지를 배치할 때 필수 환경 변수를 설정했는지 확인하십시오.