빠른 시작 - 애플리케이션 엔드투엔드 모니터링

아티클
10/01/2024

참고 항목

기본, 표준 및 엔터프라이즈 계획은 2025년 3월 중순부터 사용되지 않으며 3년의 은퇴 기간이 있습니다. Azure Container Apps로 전환하는 것이 좋습니다. 자세한 내용은 Azure Spring Apps 사용 중지 공지 사항을 참조하세요.

표준 소비 및 전용 계획은 2024년 9월 30일부터 사용되지 않으며 6개월 후에 완전히 종료됩니다. Azure Container Apps로 전환하는 것이 좋습니다. 자세한 내용은 Azure Spring Apps 표준 사용량 및 전용 계획을 Azure Container Apps로 마이그레이션을 참조 하세요.

이 문서는 기본/표준 ✅ 엔터프라이즈에 ❎ 적용됩니다.

이 빠른 시작에서는 Application Insights 및 Log Analytics를 사용하여 Azure Spring Apps 엔터프라이즈 플랜을 실행하는 앱을 모니터링하는 방법을 보여줍니다.

참고 항목

App Insights, Log Analytics, New Relic, Dynatrace, AppDynamics, Elastic 또는 Splunk를 비롯한 원하는 도구와 플랫폼을 사용하여 Spring 워크로드 엔드투엔드를 모니터링할 수 있습니다. 자세한 내용은 이 문서의 뒷부분에 있는 다른 모니터링 도구 사용을 참조하세요.

필수 조건

활성 구독이 있는 Azure 계정. 체험 계정을 만듭니다.
Azure Marketplace 엔터프라이즈 플랜의 요구 사항 섹션을 이해하고 이행합니다.
Azure CLI 버전 2.45.0 이상.
Git
Azure Spring Apps Enterprise 계획 확장입니다. 다음 명령을 사용하여 이전 버전을 제거하고 최신 엔터프라이즈 플랜 확장을 설치합니다. 이전에 spring-cloud 확장을 설치한 경우 구성 및 버전 불일치를 방지하기 위해 이 확장을 제거합니다.
```
az extension add --upgrade --name spring
az extension remove --name spring-cloud
```
다음 빠른 시작에서 만든 리소스와 같이 모니터링할 리소스:

애플리케이션 업데이트

Application Insights 연결 문자열을 두문 서비스(ASP.NET core) 및 카트 서비스(python) 애플리케이션에 수동으로 제공해야 합니다. 다음 지침에서는 이 연결 문자열을 제공하고 Application Insights의 샘플링 속도를 높이는 방법을 설명합니다.

참고 항목

현재 Java 및 NodeJS 애플리케이션용 빌드팩만 Application Insights 계측을 지원합니다.

다음 명령을 사용하여 리소스 이름을 저장할 변수를 만듭니다. 자리 표시자를 사용자의 값으로 바꿔야 합니다. Azure Spring Apps 서비스 인스턴스의 이름은 4자에서 32자 사이여야 하며 소문자, 숫자 및 하이픈만 포함할 수 있습니다. 서비스 이름의 첫 글자는 문자여야 하며 마지막 문자는 문자 또는 숫자여야 합니다.
```
export RESOURCE_GROUP="<resource-group-name>"
export APP_INSIGHTS_NAME="<app-insights-name>"
export KEY_VAULT_NAME="<key-vault-name>"
export AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME="<Azure-Spring-Apps-service-instance-name>"
```
참고 항목

기본적으로 APP_INSIGHTS_NAME AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME 동일합니다.

다음 명령을 사용하여 Application Insights 연결 문자열을 검색하고 Key Vault에서 설정합니다.

export CONNECTION_STRING=$(az monitor app-insights component show \
    --resource-group ${RESOURCE_GROUP} \
    --app ${APP_INSIGHTS_NAME} \
    --query "connectionString" \
    --output tsv)

az keyvault secret set \
    --vault-name ${KEY_VAULT_NAME} \
    --name "ApplicationInsights--ConnectionString" \
    --value ${CONNECTION_STRING}

다음 명령을 사용하여 Application Insights 바인딩의 샘플링 속도를 업데이트한 후 사용 가능한 데이터의 양을 늘립니다.

az spring build-service builder buildpack-binding set \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --builder-name default \
    --name default \
    --type ApplicationInsights \
    --properties sampling-rate=100 connection_string=${CONNECTION_STRING}

다음 명령을 사용하여 애플리케이션을 다시 시작한 후 구성을 다시 로드합니다.

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name cart-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name order-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name catalog-service

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name frontend

az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name payment-service

Single Sign-On을 구성한 경우 다음 명령을 사용하여 애플리케이션을 다시 시작하여 ID 서비스 앱 구성을 다시 로드합니다.
```
az spring app restart \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --name identity-service
```
Java 및 NodeJS 애플리케이션의 경우 다시 시작하면 새 샘플링 속도를 적용할 수 있습니다. Java가 아닌 애플리케이션의 경우 다시 시작하면 Key Vault에서 새로 추가된 계측 키에 액세스할 수 있습니다.

로그 보기

앱 인스턴스당 실시간 로그의 로그 스트리밍 또는 고급 쿼리 기능이 있는 집계 로그의 Log Analytics로 Azure Spring Apps의 로그를 볼 수 있는 두 가지 방법이 있습니다.

로그 스트리밍 사용

애플리케이션을 통해 이동하고, 카탈로그를 보고, 주문을 하여 애플리케이션에서 트래픽을 생성합니다. 취소될 때까지 다음 명령을 사용하여 트래픽을 지속적으로 생성합니다.

export GATEWAY_URL=$(az spring gateway show \
    --resource-group ${RESOURCE_GROUP} \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --query "properties.url" \
    --output tsv)

export GATEWAY_URL=https://${GATEWAY_URL} 

cd azure-spring-apps-enterprise/load-test/traffic-generator
./gradlew gatlingRun-com.vmware.acme.simulation.GuestSimulation.java

다음 명령을 사용하여 카탈로그 서비스 애플리케이션에서 최근 애플리케이션 콘솔 로그 100줄을 가져옵니다.

az spring app logs \
    --resource-group ${RESOURCE_GROUP} \
    --name catalog-service \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --lines 100

--follow 옵션을 추가하면 앱에서 실시간 로그 스트리밍을 가져올 수 있습니다. 다음 명령을 사용하여 카탈로그 서비스 애플리케이션에 대한 로그 스트리밍을 시도합니다.

az spring app logs \
    --resource-group ${RESOURCE_GROUP} \
    --name catalog-service \
    --service ${AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME} \
    --follow

팁

az spring app logs --help를 사용하여 더 많은 매개 변수 및 로그 스트림 기능을 탐색할 수 있습니다.

Log Analytics 사용

Azure Portal로 이동하여 만든 Log Analytics 인스턴스를 엽니다. Azure Spring Apps 서비스 인스턴스를 만든 동일한 리소스 그룹에서 Log Analytics 인스턴스를 찾을 수 있습니다.

Log Analytics 페이지에서 로그 창을 선택하고 Azure Spring Apps에 대해 다음 샘플 쿼리를 실행합니다.

다음 Kusto 쿼리를 입력하고 실행하여 애플리케이션 로그를 확인합니다.

AppPlatformLogsforSpring
| where TimeGenerated > ago(24h)
| limit 500
| sort by TimeGenerated
| project TimeGenerated, AppName, Log