APMのサービス、トレース、スパンを関連リソースにリンクする 🔗
Create global data links to link Splunk APM properties, such as services, traces, spans, and span tags, to relevant resources. For example, you can link APM properties to Infrastructure Monitoring navigators and dashboards, Splunk instances, Kibana logs, Splunk AppDynamics tiers, or custom URLs.
また、グローバルデータリンクを使用して、閲覧中のプロパティに関するコンテキスト情報をリンク済みのリソースに動的に転送し、関連情報に素早くアクセスできるようにすることができます。
グローバルデータリンクの利用方法については、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のダッシュボードにリンクする 🔗
You can create a global data link that passes information about APM services, traces, and spans to custom dashboards available in Splunk Observability Cloud. When you select a global data link to an Infrastructure Monitoring dashboard, the entire context of the property you were viewing transfers to the dashboard. For example, if you were viewing a service, the global data link transfers information about any endpoints you filtered for, the selected environments, and any tags you filtered for within the selected time range to the dashboard.
次のタスクは、Infrastructure Monitoringのダッシュボードにリンクするサービスのグローバルデータリンクを作成する方法について説明したものです。任意のサービスまたは特定のサービスのグローバルデータリンクを設定できます。
Splunk Observability Cloudのメインメニューで、Settings を選択し、次に Global Data Links を選択します。
Select New Link.
Enter a Link Label. This is what you select when you want to use the global data link to drill down into a specific service. For example, you might enter Trace Ingest Dashboard.
For Show On, select Any Value of and enter sf_service to associate the global data link with every service. If you want to create the global data link for a specific service, select Property:Value Pair and enter sf_service:<yourServiceName> for the service you want to create the global data link for.
If you want the global data link to display based on the Show On value and 1 or more additional conditions, select Add Conditions. To define a condition based on a property name, select Any Value of and enter a property name. To define a condition based on a property name and a specific value, select Property:Value Pair and enter a property name and value pair. If you define multiple conditions, all conditions must be met for the link to display.
Select Choose Dashboard and select the dashboard you want to associate with the global data link.
Select Save. When you view a service that matches the Show On value, you can carry the entire context of the service to the dashboard.
APMのプロパティをSplunkプラットフォームのログにリンクする 🔗
APMのサービス、トレース、スパンに関する情報をSplunk Cloud PlatformまたはSplunk Enterpriseのサーチに渡すグローバルデータリンクを作成できます。つまり、分析中のサービス、トレースID、スパンIDのログを解析するSplunkサーチクエリを実行するグローバルデータリンクを作成できます。
Splunkインスタンスのログに接続したいAPMのプロパティごとにグローバルデータリンクを作成します。たとえば、トレースIDをSplunkインスタンスのログに接続する場合は、トレースIDのコンテキストをSplunkインスタンスに届けるグローバルデータリンクを作成します。スパンIDをSplunkインスタンスのログに接続する場合は、スパンIDのコンテキストをSplunkインスタンスに届けるグローバルデータリンクを作成します。
The following task describes how to create a global data link for a trace ID. The global data link runs a Splunk search query for log events that include a specific trace ID in a Splunk instance. The process is the same for creating a global data link for a service, span ID, or span tag: use a Show On value for the property you want to create a global data link for.
Splunk Observability Cloudのメインメニューで、Settings を選択し、次に Global Data Links を選択します。
Select New Link.
Enter a Link Label. This is what you select when you want to use the global data link to drill down into a specific trace ID. For example, you might enter Splunk Cloud Platform Search.
For Link to, select Splunk.
For Show On, select Any Value of and enter trace_id.
If you want the global data link to display based on the Show On value and one or more additional conditions, select Add Conditions. To define a condition based on a property name, select Any Value of and enter a property name. To define a condition based on a property name and a specific value, select Property:Value Pair and enter a property name and value pair. If you define multiple conditions, all conditions must be met for the link to display.
Enter the Splunk instance fully qualified domain name (FQDN) and port of your Splunk instance for the URL. For example, you might enter https://<yourHostname>.splunkcloud.com:443 for a Splunk Cloud Platform instance. You might also specify the FQDN and port for a Splunk Enterprise instance you have access to.
Keep the Minimum Time Window at 1m.
If your Splunk instance refers to fields differently than APM refers to them, associate APM fields with related fields in Splunk. For example,
sf_servicein APM could beservicein your Splunk instance. If something like this is the case, specify the Splunk Observability Cloud Term value and map it to an External Term value.Select Save. When you view a specific trace, you can drill down into this global data link and view a Splunk search that includes all log events with the trace ID within the time range of the trace.
APMのプロパティをKibanaのログにリンクする 🔗
APMのサービス、トレース、スパンに関する情報をKibana URLに渡すグローバルデータリンクを作成できます。Kibana URLにAPMのプロパティとその特性を渡すことで、Splunk Observability CloudからKibanaにコンテキストを転送できます。
The following task describes how to create a global data link for a log filter in Kibana for a selected trace ID. You can also filter on other APM properties: use a Show On value for the property you want to create a global data link for.
Splunk Observability Cloudのメインメニューを開きます。
Data Configuration にカーソルを合わせ、Global Data Links を選択します。
Select New Link.
Enter a Link Label. This is what you select when you want to use the global data link to drill down into a specific trace ID. For example, you might enter Kibana filter.
For Link to, select Kibana.
For Show On, select Any Value of and enter trace_id.
If you want the global data link to display based on the Show On value and one or more additional conditions, select Add Conditions. To define a condition based on a property name, select Any Value of and enter a property name. To define a condition based on a property name and a specific value, select Property:Value Pair and enter a property name and value pair. If you define multiple conditions, all conditions must be met for the link to display.
Enter a Kibana URL that includes the trace_id field in a log filter for the URL. For example, you can enter a URL like this one:
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))Enter your preferred Time Format.
Keep the Minimum Time Window at 1m.
If Kibana refers to fields differently than APM refers to them, associate APM fields with related fields in Kibana. For example,
sf_servicein APM could beservicein Kibana. If something like this is the case, specify the Splunk Observability Cloud Term and External Term. If the field names are the same, skip this step.Select Save. When you view a specific trace, you can drill down into this global data link and view a Splunk search that includes all log events with the trace ID within the time range of the trace.
Link APM properties to Splunk AppDynamics tiers 🔗
注釈
You can only create a global data link from a Splunk APM inferred service to a Splunk AppDynamics tier if the tier is monitored by a Splunk AppDynamics SaaS environment.
This section describes how to create global data links to Splunk AppDynamics tiers using the user interface. To programmatically create global data links with Terraform, see Manage global data links to Splunk AppDynamics tiers with Terraform.
Splunk Observability Cloudのメインメニューで、Settings を選択し、次に Global Data Links を選択します。
Select New link.
Enter a Link label. This is what you select when you want to use the global data link to drill down into a specific Splunk AppDynamics tier. For example, you might enter Splunk AppDynamics tier.
For Link to, select AppDynamics tier.
For Show on, select an inferred service from the list. For more information on inferred services, see 推定サービスのパフォーマンスを分析する.
For URL, enter the Splunk AppDynamics tier URL. To obtain the tier URL, navigate to the tier in the Splunk AppDynamics UI and copy the URL from the browser. Ensure that you capture the entire URL and that it contains the controller URL, application ID, and application component.
Select Save. When you view an inferred service in the APM Service Map, you can select the data link to navigate to the service in 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のダッシュボードにリンクする 🔗
Create a global data link specifically for a single inferred service to associate a navigator or dashboard with the inferred service as the top-ranked navigator or dashboard. The top-ranked entity is the View Navigator/View Dashboard option in the Monitoring tab when you view a service from the service list or service map.
Triggers for global data links for navigators or dashboards that use wildcards (*) for service names can’t be top-ranked navigators or dashboards for inferred services.
For example, a navigator or dashboard associated with a global data link that contains a Show On value of sf_service:* can’t be a top-ranked navigator or dashboard for an inferred service. To create a global data link that acts as a default navigator or dashboard for an inferred service from the Monitoring tab, the Show On value must include the name of the inferred service. For example, if you are creating a global data link for a default navigator or dashboard for the inferred service mydb, the Show On value must be sf_service:mydb.
Next steps 🔗
To use global data links in the user interface, see APMのサービス、トレース、スパンにリンクされた関連リソースにアクセスする.