Notification Hubs에 대한 리소스 로그 사용

아티클
07/31/2024

Azure Notification Hubs 네임스페이스 사용을 시작할 때 네임스페이스가 생성, 삭제, 액세스되는 방법과 시기를 모니터링하는 것이 좋습니다. 이 문서에서는 이용 가능한 모든 작업 및 진단 로그의 개요를 제공합니다.

Azure Notification Hubs는 현재 Azure Notification Hubs 네임스페이스에서 수행되는 관리 작업을 캡처하는 활동 및 작업 로그를 지원합니다.

리소스 로그 스키마

모든 로그는 다음의 두 위치에서 JSON(JavaScript Object Notation) 형식으로 저장됩니다.

AzureActivity: Azure Portal 또는 Azure Resource Manager 템플릿 배포를 통해 네임스페이스에 대해 수행하는 작업 및 활동의 로그를 표시합니다.
AzureDiagnostics: API 또는 언어 SDK 관리 클라이언트를 통해 네임스페이스에 대해 수행하는 작업 및 활동의 로그를 표시합니다.

진단 로그 문자열에 포함된 요소의 목록은 Azure Monitor 로그 테이블을 참조하세요.

작업 로그 JSON 문자열 예제는 다음과 같습니다.

{
    "operationName": "Microsoft.NotificationHubs/Namespaces/NotificationHubs/authorizationRules/action",
    "resourceId": "/SUBSCRIPTIONS/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/RESOURCEGROUPS/SAMPLES/PROVIDERS/MICROSOFT.NOTIFICATIONHUBS/NAMESPACES/SAMPLE-NS",
    "time": "1/1/2021 5:16:32 AM +00:00",
    "category": "OperationalLogs",
    "resultType": "Succeeded",
    "resultDescription": "Gets Hub Authorization Rules",
    "correlationId": "aaaa0000-bb11-2222-33cc-444444dddddd",
    "callerIdentity": "{ \"identityType\": \"Portal\", \"identity\": \"\" }"
}

callerIdentity 필드는 비어 있거나 다음 형식 중 하나인 JSON 문자열일 수 있습니다.

Azure Portal에서 시작된 호출의 경우 identity 필드가 비어 있습니다. 로그와 활동 로그의 상관 관계를 지정하여 로그인한 사용자를 확인할 수 있습니다.

{
    "identityType": "Portal",
    "identity": ""
}

Azure Resource Manager를 통한 호출의 경우 identity 필드에 로그인한 사용자의 사용자 이름이 포함됩니다.

{
   "identityType": "Username",
   "identity": "test@foo.com"
}

Notification Hubs REST API 호출의 경우 identity 필드에 SharedAccessSignature 토큰을 생성하는 데 사용된 액세스 정책의 이름이 포함됩니다.

{
   "identityType": "KeyName",
   "identity": "SharedAccessRootKey2"
}

작업 로그에 캡처된 이벤트 및 작업

작업 로그는 Azure Notification Hubs 네임스페이스에서 수행된 모든 관리 작업을 캡처합니다. 데이터 작업은 알림 허브에서 수행되는 대량의 데이터 작업으로 인해 캡처되지 않습니다.

운영 로그에 캡처된 관리 작업 목록은 Microsoft.NotificationHubs 리소스 공급자 작업을 참조하세요.

작업 로그 사용

작업 로그는 기본적으로 사용되지 않습니다. 로그를 사용하도록 설정하려면 다음을 수행합니다.

Azure Portal에서 Azure Notification Hubs 네임스페이스로 이동한 다음, 모니터링에서 진단 설정을 선택합니다.
진단 설정 창에서 진단 설정 추가를 선택합니다.
다음 단계를 수행하여 진단 설정을 구성합니다.

a. 이름 상자에 진단 설정의 이름을 입력합니다.

b. 진단 로그에 다음 세 가지 대상 중 하나를 선택합니다.
- Log Analytics 작업 영역에 보내기를 선택한 경우 진단이 전송될 Log Analytics 인스턴스를 지정해야 합니다.
- 스토리지 계정에 보관을 선택하는 경우 진단 로그가 저장될 스토리지 계정을 구성해야 합니다.
- 이벤트 허브에 스트리밍을 선택하는 경우 진단 로그를 스트림할 이벤트 허브를 구성해야 합니다.
c. OperationalLogs 확인란을 선택합니다.
저장을 선택합니다.