Skip to content

ログ：ECSの表記揺れ修正 #286

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ma91n merged 2 commits into from
Dec 18, 2025
Merged

ログ：ECSの表記揺れ修正 #286

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
565de53
Update log_guidelines.md
MasatoYagi Dec 18, 2025
30b2bac
Update log_guidelines.md
MasatoYagi Dec 18, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions documents/forLog/log_guidelines.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -233,14 +233,14 @@ NewRelic、DataDogなども独自のキーがあるが、OTelのエクスポー
| 大分類 | 小分類 | キー名 | 説明 | 例 | 理由 |
| :----------- | :--------------- | :--------------------------------------------------------------------- | :------------------------------------------- | :------------------------------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 共通スキーマ | コアフィールド | timestamp | タイムスタンプ。可読性の高いISO 8601形式 | "2025-08-26T10:30:00.123456789Z" | OTel, ECSの両方で必須 |
| | | severity.text （※使用しているライブラリによってはlevelのままでも許容） | 人間が読むための主要な重大度レベル | "ERROR" | OTel規約に準拠。ecsでは [log.level](https://www.elastic.co/docs/reference/ecs/ecs-log#field-log-level) |
| | | severity.text （※使用しているライブラリによってはlevelのままでも許容） | 人間が読むための主要な重大度レベル | "ERROR" | OTel規約に準拠。ECSでは [log.level](https://www.elastic.co/docs/reference/ecs/ecs-log#field-log-level) |
| | | message | ログの主要なペイロード | "User login failed" | OTelのBodyに相当。ECSでは[message](https://www.elastic.co/docs/reference/ecs/ecs-base#field-message) |
| | ロガーで自動付与 | service.name | システム内でサービスを識別する最も重要な属性 | "authentication-service" | OTel, ECS, DataDog, New Relic全てで中核 |
| | | service.version | リリースの追跡とリグレッション分析に不可欠 | "1.2.3" | OTel, ECS, DataDogで標準 |
| | | deployment.environment | 本番/ステージング環境のフィルタリングに必須 | "production" | OTel, DataDogで標準 |
| | 計装で自動付与 | trace_id | 分散トレースへの基本的なリンク | "a1b2c3d4e5f6..." | OTel, ECS, New Relicに準拠（DataDogはdd.trace_idにマッピング要） |
| | | span_id | トレース内の特定の操作へのリンク | "f1e2d3c4b5a6..." | OTel, ECS, New Relicに準拠（DataDogはdd.span_idにマッピング要） |
| 拡張スキーマ | HTTP要求/応答 | http.request.method | HTTPメソッド | "GET" | `OTelとECSのHTTP規約から規定` |
| 拡張スキーマ | HTTP要求/応答 | http.request.method | HTTPメソッド | "GET" | OTelとECSのHTTP規約から規定 |
| | | http.response.status_code | HTTPステータスコード | 200 | |
| | | url.path | リクエストURL | "/users/123?query=abc" | OTelでは[url.path](https://opentelemetry.io/docs/specs/semconv/registry/attributes/url/#url-path) |
| | | user_agent.original | ユーザーエージェント | "Mozilla/5.0..." | |
Expand All @@ -251,10 +251,10 @@ NewRelic、DataDogなども独自のキーがあるが、OTelのエクスポー
| | | db.statement | 実行SQL文 | "SELECT \* FROM users WHERE id \=?" | |
| | | db.operation | 実行操作 | "SELECT" | |
| | | db.duration | クエリ実行時間（ナノ秒） | 15000000 | |
| | 例外 | exception.type | 例外クラス名 | "java.lang.NullPointerException" | OTelでは[exception](https://opentelemetry.io/docs/specs/semconv/exceptions/exceptions-logs)を利用。ecsでは [error](https://www.elastic.co/docs/reference/ecs/ecs-error) |
| | 例外 | exception.type | 例外クラス名 | "java.lang.NullPointerException" | OTelでは[exception](https://opentelemetry.io/docs/specs/semconv/exceptions/exceptions-logs)を利用。ECSでは [error](https://www.elastic.co/docs/reference/ecs/ecs-error) |
| | | exception.message | エラーメッセージ | "Cannot invoke method on null object" | |
| | | exception.stack_trace | スタックトレース | "at com.example.MyClass..." | |
| | | event.kind | イベントの種類 | "event" | ecsでは [event](https://www.elastic.co/docs/reference/ecs/ecs-event) |
| | | event.kind | イベントの種類 | "event" | ECSでは [event](https://www.elastic.co/docs/reference/ecs/ecs-event) |
| | | event.category | イベントのカテゴリ | "error" | |
| | | event.outcome | イベントの結果 | "failure" | |

Expand Down
Loading