翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# トレースの検出
トレースの検出ページには、OpenSearch Service オブザーバビリティワークスペースで分散トレースデータを探索するための専用インターフェイスが用意されています。サービスの RED メトリクス (レート、エラー率、期間) を表示したり、ファセットフィルタリングでトレーススパンを参照したり、個々のスパンとトレースをドリルダウンしてパフォーマンスの問題を診断したりできます。このページでは、トレースと関連するログデータの関連付けもサポートしています。
## トレースページにアクセスするには
オブザーバビリティワークスペースで、左側のナビゲーションで**検出**を展開し、**トレース**を選択します。
## トレースデータセットの設定
トレースデータを調べる前に、トレースデータセットを設定する必要があります。データセットは、自動または手動で作成できます。
### データセットの自動作成
トレースの検出ページに初めて移動し、トレースデータがドメインに存在すると、データセットを自動的に作成するよう求められます。**データセットの作成**を選択して、デフォルト設定を受け入れます。
### 手動データセット作成
トレースデータセットを手動で作成するには、「」の手順に従います[トレースデータセットを作成するには](observability-datasets.md#observability-datasets-create-traces)。手動作成では、インデックスパターン、タイムスタンプフィールド、データセット名を制御できます。
## トレースデータの探索
トレースの検出ページには、トレースデータを探索するための以下のコンポーネントが表示されます。
+ **RED メトリクス** – 選択したデータセットのレート (1 秒あたりのリクエスト数）、エラーレート (失敗したリクエストの割合）、期間 (レイテンシーパーセンタイル数) を表示します。これらのメトリクスは、時間フィルターに基づいて更新されます。
+ ファ**セットフィールド** – サービス名、オペレーション、ステータスコード、およびその他のスパン属性でトレーススパンをフィルタリングします。ファセットフィールドパネルの値を選択して、結果を絞り込みます。
+ **スパンテーブル** – 個々のスパンを、トレース ID、スパン ID、サービス名、オペレーション、期間、ステータスの列で参照します。任意の列でソートし、行を展開してスパンの詳細を表示できます。
## 特定のスパンの表示
特定のスパンの詳細を表示するには、スパンテーブルのスパン行を選択します。フライアウトパネルが開き、スパン属性、リソース属性、イベント情報が表示されます。
## トレースの詳細ページ
トレース全体を表示するには、スパンテーブルまたはフライアウトパネルでトレース ID リンクを選択します。トレースの詳細ページには、トレース内のすべてのスパン、そのタイミング関係、全体的なトレース期間を示すウォーターフォールグラフが表示されます。個々のスパンを展開して属性を表示し、ボトルネックを特定できます。
## トレースとログの関連付け
トレースデータセットとログデータセットとの相関を設定すると、トレースの検出ページから直接関連するログエントリを表示できます。相関関係の作成については、「」を参照してください[相関関係](observability-correlations.md)。
### 関連ログの表示
スパンの詳細フライアウトまたはトレースの詳細ページで、**関連ログ**タブを選択して、スパンのトレース ID、サービス名、時間範囲に一致するログエントリを表示します。この相関関係は、スパンの実行中にアプリケーションで何が起こったかを理解するのに役立ちます。
### コンテキストによるログリダイレクト
トレーススパンから、関連するコンテキストが保持された Discover Logs ページに直接移動できます。関連するログパネルからログ**で表示**を選択し、スパンのトレース ID と時間範囲でフィルタリングするクエリが事前入力された検出ログページを開きます。
## PPL を使用したトレースのクエリ
PPL を使用してトレースデータを直接クエリできます。PPL は、パイプ文字を使用してスパンデータをフィルタリング、変換、集計するコマンドを連鎖します。
次の例では、10 個の最も遅いトレースを見つけます。
```
source = otel-v1-apm-span-*
| where durationInNanos > 5000000000
| fields traceId, serviceName, name, durationInNanos
| sort - durationInNanos
| head 10
```
次の例では、サービスごとにエラーをカウントします。
```
source = otel-v1-apm-span-*
| where status.code = 2
| stats count() as errorCount by serviceName
| sort - errorCount
```
次の の例では、特定のサービスのトレースを検索します。
```
source = otel-v1-apm-span-*
| where serviceName = 'checkout-service'
| where parentSpanId = ''
| sort - startTime
| head 20
```