> Source: https://www.ymotongpoo.com/works/otel-specs-ja/semconv/azure/azure-events/


# Azureリソースログイベントに関するセマンティック規約

**ステータス**: [Development][DocumentStatus]

この文書では、Azure Resource Logイベントを発行する計装のためのセマンティック規約を定義します。

## Azure Resource Log

<!-- semconv event.azure.resource.log -->
<!-- NOTE: THIS TEXT IS AUTOGENERATED. DO NOT EDIT BY HAND. -->
<!-- see templates/registry/markdown/snippet.md.j2 -->
<!-- prettier-ignore-start -->

**Status:** ![Development](https://img.shields.io/badge/-development-blue)

イベント名は `azure.resource.log` でなければなりません（MUST）。

Azure Resource Logイベントについて説明します。詳細は[Azure Resource Logの最上位スキーマ](https://learn.microsoft.com/azure/azure-monitor/essentials/resource-logs-schema#top-level-common-schema)を参照してください。

**Attributes:**

| Key | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| [`azure.service.request.id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/azure/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | サービスリクエストの一意の識別子。Azureサービスによって生成され、レスポンスとともに返されます。 | `00000000-0000-0000-0000-000000000000` |
| [`cloud.resource_id`](https://opentelemetry.io/docs/specs/semconv/registry/attributes/cloud/) | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ログの発行元である[完全修飾Azureリソース ID](https://learn.microsoft.com/rest/api/resources/resources/get-by-id)。 | `arn:aws:lambda:REGION:ACCOUNT_ID:function:my-function`; `//run.googleapis.com/projects/PROJECT_ID/locations/LOCATION_ID/services/SERVICE_ID`; `/subscriptions/<SUBSCRIPTION_GUID>/resourceGroups/<RG>/providers/Microsoft.Web/sites/<FUNCAPP>/functions/<FUNC>` |

**Body fields:**

:warning: セマンティック規約のツールが複合属性をサポートするようになったら、Body fieldsは複合属性へ移行される予定です（[#1870](https://github.com/open-telemetry/semantic-conventions/issues/1870)を参照）。

| Field Name | Stability | [Requirement Level](/works/otel-specs-ja/semconv/general/attribute-requirement-level/) | Value Type | Description | Example Values |
| --- | --- | --- | --- | --- | --- |
| `category` | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ログエントリのAzureカテゴリー。 | `AuditEvent`; `GatewayLogs`; `ApplicationGatewayAccessLog` |
| `correlation.id` | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | ログエントリの会話ID。 | `607964b6-41a5-4e24-a5db-db7aab3b9b34` |
| `duration` | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | int | 操作の実行時間（ミリ秒単位）。 | `1000` |
| `identity` | ![Development](https://img.shields.io/badge/-development-blue) | `Opt-In` | undefined | "操作を実行したユーザーまたはアプリケーションのアイデンティティを記述するJSON blob。" [1] | |
| `operation.name` | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | 操作の名前。 | `SecretGet`; `Microsoft.ApiManagement/GatewayLogs`; `ApplicationGatewayAccess` |
| `operation.version` | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | 操作のバージョン。 | `1.0` |
| `properties` | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | undefined | Azure Resource Logで提供されるプロパティ。 | |
| `result.description` | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | 結果の説明。 | `The operation was successful`; `The operation failed` |
| `result.signature` | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | 記録されたイベントに関連付けられたサブステータス。 | `OK` |
| `result.type` | ![Development](https://img.shields.io/badge/-development-blue) | `Recommended` | string | 記録されたイベントに関連付けられたステータス。 | `Succeeded`; `Failed`; `Started` |
| `tenant.id` | ![Development](https://img.shields.io/badge/-development-blue) | `Conditionally Required` [2] | string | このイベントが紐づけられているActive Directoryテナントのテナント ID。 | `00000000-0000-0000-0000-000000000000` |

**[1]:** 通常、このフィールドにはActive Directoryからの認可情報とクレームまたはJWTトークンが含まれます。

> [!Warning]
> このフィールドには機密（PII）情報が含まれます。

**[2] `tenant.id`:** イベントがActive Directoryテナントに紐づけられている場合。

<!-- prettier-ignore-end -->
<!-- END AUTOGENERATED TEXT -->
<!-- endsemconv -->

[DocumentStatus]: https://opentelemetry.io/docs/specs/otel/document-status