APMのサービス、トレース、スパンを関連リソースにリンクする 🔗
グローバルデータリンクを作成して、Splunk APMのサービス、トレース、スパン、スパンタグといったプロパティを関連リソースにリンクします。たとえば、APMのプロパティをInfrastructure Monitoringのナビゲーターおよびダッシュボード、Splunkインスタンス、Kibanaログ、Splunk AppDynamics階層、またはカスタムURLにリンクできます。
また、グローバルデータリンクを使用して、閲覧中のプロパティに関するコンテキスト情報をリンク済みのリソースに動的に転送し、関連情報に素早くアクセスできるようにすることができます。
グローバルデータリンクの利用方法については、APMのサービス、トレース、スパンにリンクされた関連リソースにアクセスする を参照してください。
前提条件 🔗
グローバルデータリンクを作成するには、adminロールが必要です。
APMのプロパティにグローバルデータリンクを作成するためのパラメータ 🔗
APMのプロパティにグローバルデータリンクを作成すると、そのプロパティのコンテキストパラメータ値をダッシュボードやカスタムURLに転送できます。以下は、APMのプロパティとそのコンテキストパラメータです。
Property |
Field |
Context parameters |
Description |
---|---|---|---|
サービス |
|
|
APMでのサービス名。これは一般的にサービスのインストルメンテーションの設定時に指定されます。 |
トレースID |
|
|
特定のトレースに関連付けられた16文字または32文字の一意識別子。 |
スパンID |
|
|
特定のスパンに関連付けられた16文字の一意識別子。 |
スパンタグ |
既存のスパンタグの値。 |
|
スパンを記述するフィールドと値のペア。スパンタグを使用してスパンを記述します。タグは、サービスのインストルメンテーションを構成する際にタグを指定します。Splunk Distribution of OpenTelemetry Collector(または現在は非推奨のSmart Agent)の設定でもスパンタグを指定できます。 |
APMのプロパティをSplunk Infrastructure Monitoringのダッシュボードにリンクする 🔗
APMのサービス、トレース、スパンに関する情報を、Splunk Observability Cloudで利用可能なカスタムダッシュボードに渡すグローバルデータリンクを作成できます。Infrastructure Monitoringのダッシュボードへのグローバルデータリンクを選択すると、表示していたプロパティの完全なコンテキストがそのダッシュボードに転送されます。たとえば、サービスを表示していた場合、グローバルデータリンクは、選択した時間範囲内でフィルタリングしたエンドポイント、選択した環境、およびフィルタリングしたタグに関する情報を、ダッシュボードに転送します。
次のタスクは、Infrastructure Monitoringのダッシュボードにリンクするサービスのグローバルデータリンクを作成する方法について説明したものです。任意のサービスまたは特定のサービスのグローバルデータリンクを設定できます。
Splunk Observability Cloudのメインメニューで、Settings を選択し、次に Global Data Links を選択します。
New Link を選択します。
Link Label を入力します。これは、特定のサービスにドリルダウンするためにグローバルデータリンクを使用する際に選択するものです。たとえば、Trace Ingest Dashboard と入力します。
Show On には、Any Value of を選択し、sf_service と入力すると、このグローバルデータリンクがすべてのサービスに関連付けられます。特定のサービスに対してグローバルデータリンクを作成する場合は、Property:Value Pair を選択し、グローバルデータリンクを作成するサービスとして sf_service:<yourServiceName> を入力します。
グローバルデータリンクを Show On の値と1つ以上の追加条件に基づいて表示させたい場合は、Add Conditions を選択します。プロパティ名に基づいて条件を定義するには、Any Value of を選択し、プロパティ名を入力します。プロパティ名と特定の値に基づいて条件を定義するには、Property:Value Pair を選択し、プロパティ名と値のペアを入力します。複数の条件を定義すると、リンクが表示されるためにはすべての条件が満たされる必要があります。
Choose Dashboard を選択し、グローバルデータリンクに関連付けたいダッシュボードを選択します。
Save を選択します。Show On の値に一致するサービスを表示すると、サービスの完全なコンテキストがダッシュボードに引き継がれます。
APMのプロパティをSplunkプラットフォームのログにリンクする 🔗
APMのサービス、トレース、スパンに関する情報をSplunk Cloud PlatformまたはSplunk Enterpriseのサーチに渡すグローバルデータリンクを作成できます。つまり、分析中のサービス、トレースID、スパンIDのログを解析するSplunkサーチクエリを実行するグローバルデータリンクを作成できます。
Splunkインスタンスのログに接続したいAPMのプロパティごとにグローバルデータリンクを作成します。たとえば、トレースIDをSplunkインスタンスのログに接続する場合は、トレースIDのコンテキストをSplunkインスタンスに届けるグローバルデータリンクを作成します。スパンIDをSplunkインスタンスのログに接続する場合は、スパンIDのコンテキストをSplunkインスタンスに届けるグローバルデータリンクを作成します。
次のタスクでは、トレース ID のグローバルデータリンクを作成する方法を説明します。グローバルデータリンクは、Splunk インスタンスの特定のトレース ID を含むログイベントに対して Splunk 検索クエリを実行します。プロセスは、サービス、スパン ID、またはスパンタグのグローバルデータリンクを作成する場合と同じです。グローバルデータリンクを作成するプロパティには、Show On 値を使用します。
Splunk Observability Cloudのメインメニューで、Settings を選択し、次に Global Data Links を選択します。
New Link を選択します。
Link Label を入力します。これは、特定のトレースIDにドリルダウンするためにグローバルデータリンクを使用する際に選択するものです。たとえば、Splunk Cloud Platform Search と入力します。
Link to の場合は、Splunk を選択します。
Show On の場合は、Any Value of を選択し、trace_id を入力します。
グローバルデータリンクを Show On の値と1つ以上の追加条件に基づいて表示させたい場合は、Add Conditions を選択します。プロパティ名に基づいて条件を定義するには、Any Value of を選択し、プロパティ名を入力します。プロパティ名と特定の値に基づいて条件を定義するには、Property:Value Pair を選択し、プロパティ名と値のペアを入力します。複数の条件を定義すると、リンクが表示されるためにはすべての条件が満たされる必要があります。
URL に、Splunkインスタンスの完全修飾ドメイン名(FQDN)とポートを入力します。たとえば、Splunk Cloud Platformのインスタンスの場合は、https://<yourHostname>.splunkcloud.com:443 と入力することになります。また、アクセス可能なSplunk EnterpriseインスタンスのFQDNとポートを指定することもできます。
Minimum Time Window を 1m に維持します。
SplunkインスタンスがAPMとは異なる方法でフィールドを参照している場合は、APMのフィールドをSplunkの関連フィールドに関連付けます。たとえば、APMの
sf_service
は、Splunkインスタンスではservice
になる可能性があります。このような場合には、Splunk Observability Cloud Term の値を指定し、External Term の値にマッピングします。Save を選択します。特定のトレースを表示する際、このグローバルデータリンクにドリルダウンして、そのトレースの時間範囲内で、このトレースIDを持つすべてのログイベントを含むSplunkサーチを表示できます。
APMのプロパティをKibanaのログにリンクする 🔗
APMのサービス、トレース、スパンに関する情報をKibana URLに渡すグローバルデータリンクを作成できます。Kibana URLにAPMのプロパティとその特性を渡すことで、Splunk Observability CloudからKibanaにコンテキストを転送できます。
次のタスクでは、選択したトレース ID に対してKibanaのログフィルター用のグローバルデータリンクを作成する方法を説明します。他のAPMプロパティでフィルタリングすることもできます。Show On の値に、グローバルリンクを作成したいプロパティを指定します。
Splunk Observability Cloudのメインメニューを開きます。
Data Configuration にカーソルを合わせ、Global Data Links を選択します。
New Link を選択します。
Link Label を入力します。これは、特定のトレースIDにドリルダウンするためにグローバルデータリンクを使用する際に選択するものです。たとえば、Kibana filter と入力します。
Link to の場合は、Kibana を選択します。
Show On の場合は、Any Value of を選択し、trace_id を入力します。
グローバルデータリンクを Show On の値と1つ以上の追加条件に基づいて表示させたい場合は、Add Conditions を選択します。プロパティ名に基づいて条件を定義するには、Any Value of を選択し、プロパティ名を入力します。プロパティ名と特定の値に基づいて条件を定義するには、Property:Value Pair を選択し、プロパティ名と値のペアを入力します。複数の条件を定義すると、リンクが表示されるためにはすべての条件が満たされる必要があります。
URL のログフィルターに trace_id フィールドを含む Kibana URLを入力します。たとえば、次のようなURLを入力します:
http://<yourKibanaFQDN>/kibana/app/kibana#/discover?_g=(refreshInterval:(display:Off,pause:!f,value:0),time:(from:'{{start_time}}',mode:absolute,to:'{{end_time}}'))&_a=(columns:!(_source),interval:auto,query:(language:kuery,query:'traceId:{{value}}'),sort:!('@timestamp',desc))
希望する Time Format を入力します。
Minimum Time Window を 1m に維持します。
KibanaがAPMとは異なる方法でフィールドを参照している場合は、APMのフィールドをKibanaの関連フィールドに関連付けます。たとえば、APMの
sf_service
は、Kibanaではservice
になる可能性があります。このような場合には、Splunk Observability Cloud Term と External Term を指定します。フィールド名が同じ場合は、この手順を飛ばしてください。Save を選択します。特定のトレースを表示する際、このグローバルデータリンクにドリルダウンして、そのトレースの時間範囲内で、このトレースIDを持つすべてのログイベントを含むSplunkサーチを表示できます。
APMプロパティをSplunk AppDynamics階層にリンクする 🔗
注釈
Splunk APM推定サービスから Splunk AppDynamics階層へのグローバルデータリンクを作成できるのは、その階層がSplunk AppDynamics SaaS環境で監視されている場合のみです。
このセクションでは、ユーザーインターフェイスを使用してSplunk AppDynamics階層へのグローバルデータリンクを作成する方法について説明します。Terraformを使用してプログラムでグローバルデータリンクを作成するには、Splunk AppDynamics階層へのグローバルデータリンクをTerraformで管理する を参照してください。
Splunk Observability Cloudのメインメニューで、Settings を選択し、次に Global Data Links を選択します。
New link を選択します。
Link label を入力します。これは、特定のSplunk AppDynamics 階層にドリルダウンするためにグローバルデータリンクを使用する際に選択するものです。たとえば、Splunk AppDynamics tier と入力します。
Link to の場合は、AppDynamics tier を選択します。
Show on では、リストから推定サービスを選択します。推定サービスの詳細については、推定サービスのパフォーマンスを分析する を参照してください。
URL の場合は、Splunk AppDynamics階層のURLを入力します。階層のURLを取得するには、Splunk AppDynamics UIで階層に移動し、ブラウザからURLをコピーします。URL全体をキャプチャし、コントローラURL、アプリケーションID、アプリケーションコンポーネントが含まれていることを確認します。
Save を選択します。APM Service Map で推定サービスが表示すると、データリンクを選択してSplunk AppDynamicsのサービスに移動できます。
カスタムURLにAPMのコンテキストを転送する 🔗
APMのサービス、トレース、またはスパンに関する情報をカスタムURLに渡すグローバルデータリンクを作成できます。
例えば、次のようなカスタムURLを指定して、サービスのコンテキストをURLに転送することができます: https://www.example.com/search/?field={{key}}&value={{value}}&service={{properties.sf_service}}&st={{start_time}}&et={{end_time}}
。
さらに詳しく 🔗
カスタムURLへのグローバルデータリンクを作成する詳細な手順については、グローバル・データリンクを使用して、メタデータを関連リソースにリンクする を参照してください。
カスタムURLグローバル・データリンク設定例 を参照してください。
カスタムURLにコンテキストを転送するために使用できるパラメータについては、APMのプロパティにグローバルデータリンクを作成するためのパラメータ を参照してください。
データベースと推定サービスをInfrastructure Monitoringのダッシュボードにリンクする 🔗
単一の推定サービス専用のグローバルデータリンクを作成して、ナビゲーターまたはダッシュボードを、トップランクのナビゲーターまたはダッシュボードとして推定サービスに関連付けます。トップランクのエンティティは、サービスリストまたはサービスマップからサービスを表示する際の Monitoring タブの View Navigator/View Dashboard オプションです。
サービス名にワイルドカード( * )を使用するナビゲーターまたはダッシュボードのグローバルデータリンクのトリガーには、推定サービスのトップランクのナビゲーターまたはダッシュボードを指定できません。
たとえば、sf_service:*
の値として Show On を含むグローバルデータリンクに関連付けられるナビゲーター/ダッシュボードには、推定サービスのトップランクナビゲーター/ダッシュボードを指定できません。Monitoring タブから推定サービスのデフォルトのナビゲーター/ダッシュボードとして機能するグローバルデータリンクを作成する場合は、 Show On の値に推定サービスの名前を含める必要があります。たとえば、推定サービス mydb
のデフォルトのナビゲーター/ダッシュボードのグローバルデータリンクを作成する場合、 Show On の値には sf_service:mydb
を指定する必要があります。
次のステップ 🔗
ユーザーインターフェイスでグローバルデータリンクを使用するには、APMのサービス、トレース、スパンにリンクされた関連リソースにアクセスする を参照してください。