Skip to content

Commit 2c8ed57

Browse files
author
Yoshi Yamaguchi
authored
[ja] translate Semantic convention and Resource (open-telemetry#4741)
1 parent 1956807 commit 2c8ed57

File tree

2 files changed

+66
-0
lines changed

2 files changed

+66
-0
lines changed
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
---
2+
title: リソース
3+
weight: 70
4+
default_lang_commit: 825b6e2
5+
---
6+
7+
## はじめに
8+
9+
{{% docs/languages/resources-intro %}}
10+
11+
オブザーバビリティバックエンドに[Jaeger](https://www.jaegertracing.io/)を使用している場合、リソース属性は**Process**タブの下にグループ化されます。
12+
13+
![トレースに関連するリソース属性の出力例を示すJaegerのスクリーンショット](screenshot-jaeger-resources.png)
14+
15+
リソースは `TraceProvider` または `MetricProvider` の初期化時に追加されます。
16+
この関連付けは後で変更することはできません。
17+
リソースが追加されると、そのプロバイダーに紐づいた `Tracer` または `Meter` から生成されるすべてのスパンとメトリクスに、そのリソースが関連付けられます。
18+
19+
## SDKが提供するデフォルト値を持つセマンティック属性
20+
21+
OpenTelemetry SDK が提供する属性があります。
22+
そのうちの1つが `service.name` で、これはサービスの論理名を表します。
23+
デフォルトでは、SDKはこの値に `unknown_service` を代入するので、コードの中で明示的に設定するか、環境変数 `OTEL_SERVICE_NAME` を設定することを推奨します。
24+
25+
さらに、SDKは自身を識別するために、`telemetry.sdk.name``telemetry.sdk.language``telemetry.sdk.version` といったリソース属性も提供します。
26+
27+
## リソース検出器
28+
29+
ほとんどの言語固有のSDKは、環境からリソース情報を自動的に検出できるリソース検出器のセットを提供しています。
30+
一般的なリソース検出器には次のようなものがあります。
31+
32+
- [オペレーティングシステム](/docs/specs/semconv/resource/os/)
33+
- [ホスト](/docs/specs/semconv/resource/host/)
34+
- [プロセスとプロセスランタイム](/docs/specs/semconv/resource/process/)
35+
- [コンテナ](/docs/specs/semconv/resource/container/)
36+
- [Kubernetes](/docs/specs/semconv/resource/k8s/)
37+
- [クラウドプロバイダー固有の属性](/docs/specs/semconv/resource/#cloud-provider-specific-attributes)
38+
- [その他](/docs/specs/semconv/resource/)
39+
40+
## カスタムリソース
41+
42+
独自のリソース属性を指定することもできます。
43+
リソース属性はコードで指定することも、環境変数 `OTEL_RESOURCE_ATTRIBUTES` に設定することもできます。
44+
該当する場合は、[リソース属性のセマンティック規約](/docs/specs/semconv/resource) を使用してください。
45+
たとえば、`deployment.environment` を使用して、[デプロイ環境](/docs/specs/semconv/resource/deployment-environment/) の名前を指定できます。
46+
47+
```shell
48+
env OTEL_RESOURCE_ATTRIBUTES=deployment.environment=production yourApp
49+
```
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
---
2+
title: セマンティック規約
3+
description: さまざまな種類の操作やデータの共通の名前
4+
weight: 30
5+
default_lang_commit: 825b6e2
6+
---
7+
8+
OpenTelemetryは[セマンティック規約](/docs/specs/semconv/)を定義していて、セマンティック属性と呼ばれることもあります。
9+
これは、さまざまな種類の操作やデータに対する共通の名前を指定するものです。
10+
セマンティック規約を使う利点は、コードベース、ライブラリ、プラットフォーム間で標準化できる共通の命名スキームに従うことです。
11+
12+
トレース、メトリクス、ログ、リソースのセマンティック規約が利用可能です。
13+
14+
- [トレースセマンティック規約](/docs/specs/semconv/general/trace/)
15+
- [メトリクスセマンティック規約](/docs/specs/semconv/general/metrics/)
16+
- [ログセマンティック規約](/docs/specs/semconv/general/logs/)
17+
- [リソースセマンティック規約](/docs/specs/semconv/resource/)

0 commit comments

Comments
 (0)