Index span tags to create Troubleshooting MetricSets 🔗

Use span tags or processes to break down services and inter-service calls along trace characteristics or attributes. To get additional value from a span tag or process, a Splunk APM administrator can run an action known as indexing, which activates additional analysis of the indexed span tag or process. One benefit of indexing is to get aggregated metrics, called MetricSets, across all spans that contain a specified indexed tag or process.

MetricSetsとは 🔗

MetricSets are metric time series (MTS) you can use to track the performance of specific metrics over time. To help you analyze your service performance, APM provides 2 categories of MetricSets: Troubleshooting MetricSets (TMS) and Monitoring MetricSets (MMS). Use Troubleshooting MetricSets for high-cardinality troubleshooting. Use Monitoring MetricSets for real-time monitoring and alerting.

APM provides a collection of MetricSets by default. You can also index additional span tags or processes to create additional TMS and, as part of the indexing process, you can opt to create custom dimensionalized Monitoring MetricSets (MMS). See APMのMetricSetsについて for an overview of the types of MetricSets in APM and a list of the MetricSets available by default.

Use this topic to learn how to index a span tag or process to create Troubleshooting MetricSets. See Create a Monitoring MetricSet with a custom dimension to learn how to add custom dimensionalized Monitoring MetricSets.

前提条件 🔗

Splunk APMでスパンタグをインデックス化してTroubleshooting MetricSetsを作成するには、adminロールが必要です。
Before indexing span tags and processes, see スパンタグとTroubleshooting MetricSetsのリファレンスおよびベストプラクティス for guidance on choosing span tags or processes to index.

Troubleshooting MetricSetsを使用して、メトリクスをフィルタリングおよび分解する 🔗

Every Troubleshooting MetricSet (TMS) creates the following metrics, also known as Request, Error, and Duration (RED) metrics. The following metrics appear when you select a service from the service map in the Troubleshooting view:

リクエスト率
エラー率
根本原因エラー率
P50、P90、P99レイテンシ

Troubleshooting MetricSetsの測定精度は10秒です。Splunk APMは、各10秒のレポートウィンドウについて、メトリクスの分散から分位数をレポートします。

TMS appear on the service map and in Tag Spotlight. Use TMS to filter the service map and create breakdowns across the values of a given indexed span tag or process.

See シナリオ：KaiがSplunk APMのサービスマップを使用してエラーの根本原因を調査する to learn more about using RED metrics in the service map.
トラブルシューティングにおけるインデックス済みタグの使用方法の詳細は、シナリオ：DeepuがTag Spotlightを使用してエラーの根本原因を見つけるを参照してください。

デフォルトのインデックス付きスパンタグ 🔗

Splunk APM indexes and generates Troubleshooting MetricSets for several tags by default. For more details about these tags, see APMのデフォルトのインデックス付きスパンタグ. You can’t modify or stop APM from indexing these span tags, but you can index additional span tags. See 新しいスパンタグまたはプロセスをインデックス化する to learn how.

新しいスパンタグまたはプロセスをインデックス化する 🔗

以下の手順に従って、スパンタグまたはプロセスをインデックス化し、Troubleshooting MetricSetを作成します。

APM MetricSets ページには、以下のいずれかの方法で移動します：
1. Splunk APMで、APM Configuration を選択し、メニューから APM MetricSets を選択する。APM MetricSetsページが開きます。
2. Splunk Observability Cloudの任意の場所から、ナビゲーションバーで Settings を選択し、Data Configuration の下にある APM MetricSets を選択する。
APM MetricSets ページで、新規MetricSet を選択します。
インデックス化したいスパンタグまたはプロセスの名前を入力します。
スコープは、APMがスパンタグやプロセスをトレース内のサービスとどのように関連付けるかを決定します：
- Select Service to associate the span tag or process with services. This means the value of the span tag or process might change across services in a given trace. Select All Services to index the span tag or process for every service. Select specific services to index the span tag or process for only those services.
  
  注釈
  
  If you index a span tag or process at the service level, you can also use it as a custom dimension in Monitoring MetricSets. See Create a Monitoring MetricSet with a custom dimension for instructions.
- グローバルを選択すると、スパンタグまたはプロセスはトレースと関連付けられます。これは、スパンタグまたはプロセスの値が特定のトレース内のすべてのサービスで同じであることを意味します。
スコープについての詳細はインデックス化できるスパンタグのタイプを参照してください。
分析の開始を選択して設定を送信します。Splunk APMがスパンタグまたはプロセスの分析を実行し、このMetricSetの潜在的なカーディナリティ寄与度を計算し、それがエンタイトルメントの制限内におさまるどうかを判断します。
カーディナリティチェックの実行中、作成したメトリクスセットは、テーブルの保留中のMetricSets セクションに、Analyzing ステータスで表示されます。チェックが実行されるまで、しばらく待つ必要があるかもしれません。

注意

Your pending MetricSet expires after 1 hour. If your MetricSet times out before you activate it, run the analysis again.
After the cardinality check has run, review the cardinality and activate your new MetricSet.
- If the cardinality impact of indexing this new MetricSet is within your subscription limit, you see a green check mark and 「Within Entitlement.」 Select the check mark under Actions to activate your Troubleshooting MetricSet.
- If the cardinality check times out before you activate the MetricSet, run the analysis again.
- カーディナリティチェックが「失敗」と表示された場合は、カーディナリティがTMSに関するサブスクリプションの制限を超えています。インデックス付きスパンタグおよびプロセスのカーディナリティ寄与度を参照してください。
以下は、カーディナリティチェックの例を示すものです。

インデックス付きスパンタグおよびプロセスのカーディナリティ寄与度 🔗

When you index a new span tag or process to create Troubleshooting MetricSets, Splunk APM runs a cardinality contribution analysis to calculate the potential total cardinality contribution after indexing the span tag or process. This gives you control of what you index and helps you to account for organization subscription limits.

カーディナリティ寄与度の合計が制限を超えて増加する可能性のあるスパンタグやプロセスをインデックス化しようとする場合、インデックス化されたスパンタグやプロセスを修正または削除することで、インデックス化されたタグやプロセスの既存のカーディナリティ寄与度を変更することができます。

TMSのサブスクリプション制限を確認するには、 Settings、Subscription Usage の順に移動します。組織のサブスクリプションによっては、この移動先が Settings、Billing and Usage の順になる場合があります。APM タブを選択し、Troubleshooting MetricSets パネルを選択して、TMSのサブスクリプション制限を表示します。サブスクリプション制限を表示するには、adminまたはusageのロールが必要です。APMの使用状況と請求の詳細については、Monitor Splunk APM billing and subscription usage を参照してください。

既存のTroubleshooting MetricSetsを管理する 🔗

スパンタグまたはプロセスを正常にインデックス化すると、Splunk APMはデータ設定の APM MetricSets ページに設定を保存します。このページにアクセスすると、スパンタグまたはプロセスのインデックス化のスコープとステータスが表示されます。

You can modify the configuration for existing indexed tags and processes, including adding and removing services for specific indexed tags or processes and modifying the scope. You can also pause or stop indexing without deleting the configuration. This is useful when you want to temporarily stop indexing a span tag or process, but don’t want to remove the configuration.

既存のインデックス付きスパンタグやプロセスを確認または修正するには、以下を実行します：

Go to Settings then Data Configuration then APM MetricSets.
設定テーブルのカスタムMetricSets セクションで、確認したいインデックス付きスパンタグまたはプロセスを見つけます。
各インデックス付きスパンタグやプロセスのステータスの解釈については、設定したTroubleshooting MetricSetsのステータスを参照してください。
Actions 列のボタンを使用して、必要な変更を加えます：
- インデックス付きスパンタグやプロセスのスコープを編集するには、鉛筆マークのボタンを使用します。
- 指定したスパンタグまたはプロセスのMetricSetsの生成を一時停止するには、一時停止ボタンを使用します。
- MetricSetの設定を削除するには、ゴミ箱ボタンを使用します。

設定したTroubleshooting MetricSetsのステータス 🔗

カスタムのTroubleshooting MetricSetsを設定した後に、そのステータスを見ることができます。次のテーブルは、利用可能なすべてのステータスの一覧です：

ステータス	説明
アクティブ	The application is indexing the span tag or process to create Troubleshooting MetricSets.
一時停止中	自分または他の管理者が、スパンタグまたはプロセスのインデックス化を一時停止しています。アプリケーションはスパンタグまたはプロセスのTroubleshooting MetricSetsを生成しておらず、以前にインデックスを作成したデータを表示できません。
中止	アプリケーションはスパンタグまたはプロセスのインデックス化を停止しており、スパンタグまたはプロセスのTroubleshooting MetricSetsを生成しなくなりました。以前にインデックスを作成したデータを表示できません。

データベースのMetricSetのステータス 🔗

You can pause and resume indexing Database Query Performance data from the Standard MetricSets section of APM MetricSets. You can also control the indexing of SQL and NoSQL tags separately.

Database Query Performanceのデータのインデックス化を一時停止するには、データベースタイプの横にある Pause indexing を選択します。再開するには、Resume indexing を選択します。

このページは 2024年08月06日に最終更新されました。

Related Topics