グローバル・データリンクを使用して、メタデータを関連リソースにリンクする 🔗
グローバル・データリンクを使用すると、Splunk Observability Cloud に表示されるメタデータを以下の関連リソースにリンクできます。
Splunk Observability Cloud のダッシュボード
Splunk Observability Cloudのナビゲーター
Splunk Cloud Platform および Splunk Enterprise
カスタムURL
Kibana ログ
Splunk RUM
Splunk AppDynamics tiers
Splunk Observability Cloud では、メタデータ (データに関するデータ) には ディメンション、プロパティ および タグ が含まれます。メタデータは製品の以下の場所に表示されます：
アラート
ダッシュボードと Splunk Infrastructure Monitoring ナビゲーターにあります。
チャート一覧
線グラフ
エリアチャート
カラムチャート
データテーブル
Splunk Application Performance Monitoring (APM) は以下の場所にあります。
サービス
トレース
スパン
For example, here is a global data link displaying for a host property on a dashboard. The global data link leads to an EC2 Cost and Usage dashboard in Splunk Observability Cloud, where the system automatically narrows the dashboard to automatically show data that’s relevant to the server4 host.
グローバル・データリンクがコンテキストで表示される例については、グローバル・データリンクにアクセスする を参照してください。
グローバル・データリンクは、閲覧中のメタデータに関するコンテキスト情報をリンク先のリソースに動的に転送するため、関連情報にすばやくアクセスできます。
グローバル・データリンクを作成すると、ダッシュボード、Splunk Infrastructure Monitoring ナビゲーター、Splunk APM、アラートメッセージなど、指定したメタデータが表示されている場所であればどこにでも表示されます。メタデータを見ることができるすべてのユーザーは、グローバル・データリンクを見ることができます。
これとは対照的に、ローカルデータリンクを作成すると、作成したダッシュボードまたはナビゲーターでのみ使用できます。メタデータを見ることができるすべてのユーザーは、ローカルデータリンクを見ることができます。ローカルデータリンクの詳細については、データリンクを使用して関連リソースに移動する を参照してください。
前提条件 🔗
グローバル・データリンクを作成するには、管理者である必要があります。
管理者アクセス権の付与については、Splunk Observability Cloudでユーザーを作成および管理する を参照してください。
グローバル・データリンクの作成 🔗
この手順では、グローバル・データリンク・ページを使用して、利用可能なすべてのメタデータのグローバル・データリンクを作成する方法について説明します。
Splunk Observability Cloud APIを使用してグローバル・データリンクを作成する方法については、Splunk Observability Cloud Developer Guideの Link Metadata to Related Content トピックを参照してください。
Splunk APM プロパティのグローバル・データリンクを作成する方法については、APMのサービス、トレース、スパンを関連リソースにリンクする を参照してください。
In the Splunk Observability Cloud main menu, select Settings then Global Data Links.
Select New Link.
In the Link Label field, enter the text you want to display as the global data link text.
In the Link to field, select your link target type. Select from the following targets for your global data link:
Custom URL: Links to a custom URL.
Splunk: Links to Splunk Cloud Platform or Splunk Enterprise.
Splunk Observability Cloud Navigator: Links to a navigator in Splunk Observability Cloud. Select Choose Navigator to select the navigator you want to link to.
Splunk Observability Cloud Dashboard: Links to a dashboard in Splunk Observability Cloud. Select Choose Dashboard to select the dashboard you want to link to.
Kibana: Links to a Kibana log.
AppDynamics tier: Links to a Splunk AppDynamics tier.
In the Show On list, select a value that indicates where you want the global data link to display:
Any Metadata Value: Display the link for any metadata value. This option isn’t available if you set the Link to field to Splunk Observability Cloud Dashboard.
Any Value of: Display the link for any value of a specific piece of metadata.
For example, select Any Value of and enter aggregration_type to display the link for any aggregration_type value.
Property:Value Pair: Display the link for a specific value of a specific piece of metadata.
For example, select Property:Value Pair and enter aggregration_type:average to display the link only for an aggregation_type value of average.
Inferred service: Display the link for an inferred service. For more information on inferred services, see 推定サービスのパフォーマンスを分析する.
If you want the link to display based on the Show On value and one or more additional conditions, select Add Conditions. If you define multiple conditions, the link only displays if all the conditions are true.
For details about how to use the Any Value of and Property:Value Pair options, see the previous step.
- If you set the Link to field to Custom URL, Splunk, Kibana, or AppDynamics tier, the URL field displays. Enter the URL you want the global data link to lead to.
For more information about the instructions and URL requirements for linking to a Splunk AppDynamics tier, see Link APM properties to Splunk AppDynamics tiers.
Optionally, for Custom URL and Kibana link target types, you can use any of the following placeholder variables in your URL. When you select the global data link, the system replaces the variables with actual values to create the destination URL.
{{key}}: Use this variable to populate the key name from the context where the link displays. For example, if you set Show on to aggregation_type,aggregation_typereplaces{{key}}in the URL.{{value}}: Use this variable to populate the key value from the context where the link displays. For example, if you set Show on to aggregation_type and the aggregation_type value in context is average,averagereplaces{{value}}in the URL.{{start_time}}: Use this variable to populate the start time of the time window from the context where the link displays. The system inserts the timestamp using the format you select in the Time Format field.{{end_time}}: Use this variable to populate the end time of the time window from the context where the link displays. The system inserts the timestamp using the format you select in the Time Format field.{{properties.<property_name>}}: Use this variable to populate other metadata from the context of the link display. For example,propertiescontains a map of the metadata key names and values that appear in the context of the global data link display. To insert a name and value from this map, use{{properties.<your_property_name>}}. If your property name has a period in it, use square brackets around the value. For example,{{properties.[<property.name>]}}.
If you select a Link to value of Custom URL or Kibana, the Time Format field appears. Set this field to select the timestamp format used for the global data link’s starting and ending timestamps. Setting this field also helps ensure compatibility with the external system you are linking to. Select one of the following time formats:
ISO 8601: YYYY-MM-DDThh:mm:ss.SSSZ
Unix Time: epoch milliseconds
Unix Time: epoch seconds
If you select a Link to value of Custom URL, Splunk, or Kibana, the Minimum Time Window field appears. The time window is the interval during which the system captured the chart, dashboard, service map, or trace data. If this interval is shorter than the minimum time window value you select here, the global data link adjusts the start time to an earlier time so the interval is as long as the minimum time window.
If you select a Link to value of Custom URL, Splunk, or Kibana, the Property mapping options appear. Use property mapping if your URL value contains Splunk Observability Cloud key names and values that are referred to differently in the external system you’re linking to.
For example, you can use property mapping to map a Splunk Observability Cloud key name, such as host, to an external system key name, such as hostname. You can also use property mapping to map an Observability key name, such as host, and key value, such as west-internal-123456, to an external system key name, such as hostname, and key value, such as 123456-west-int.
To use property mapping, select Choose a Property to select a Splunk Observability Cloud key name or key name and value pair. Then, enter the external key name or key name and value pair that you want to map to in the External Term field.
Select Save.
また、グローバル・データリンクを作成できる Splunk Observability Cloud の他の場所をいくつか紹介します。
データリンクを含むアラートメッセージを表示する場合、データリンクの横にある More メニュー( ⋯ )を選択し、Configure data links を選択します。
When you are on a dashboard, select Data Links from the Dashboard actions menu. If there are existing global data links defined for your organization, you can see a message to that effect on the Data Links tab. Select Global Data Links.
Splunk Infrastructure Monitoring ナビゲーターでリストを表示する際、任意のプロパティの Actions メニューを選択し、Configure data links を選択します。
When you view an inferred service on the APM Service Map, select the (⋯) menu next to the inferred service name. Then select Configure data links.
ダッシュボードからデータリンクを作成するときにグローバル・データリンクを作成するには、Entire Organization のスコープを選択します。
カスタムURLグローバル・データリンク設定例 🔗
Global Data Links ページで入力するフィールド値を説明するために、カスタム URL へのグローバル・データリンクの設定例を示します：
This global data link displays for the aggregation_type metadata on a dashboard, as shown here:
グローバル・データリンクを選択すると、Global Data Links ページで定義した URL がすぐに表示されます。例えば、以下の例で定義したURLを考えてみましょう：
https://www.example.com/search/?field={{key}}&value={{value}}&service={{properties.unit}}&st={{start_time}}&et={{end_time}}
When you select the global data link for an aggregation_type metadata value of total, the URL appears in the following form:
https://www.example.com/search/?field=aggreg-type&value=ttl&service=Bytes&st=2021-09-02T01:13:30.000Z&et=2021-09-02T01:18:30.000Z
グローバル・データリンクの設定例については、以下のトピックを参照してください。これらのトピックは Splunk APM プロパティに固有のものですが、ガイダンスはどのプロパティにも適用できます。
グローバル・データリンクにアクセスする 🔗
グローバル・データリンクを作成すると、指定したメタデータが Splunk Observability Cloud の以下の関連領域に表示されます。グローバル・データリンクを作成するには管理者である必要がありますが、作成したグローバル・データリンクには誰でもアクセスできます。
データテーブル 🔗
データテーブルについては、「データテーブル」タブを見る を参照してください。
チャート一覧 🔗
リストチャートについては リストチャート を参照してください。
アラートメッセージ 🔗
アラートについては、Splunk Observability Cloudでアラートを表示する を参照してください。
Splunk Application Performance Monitoring (APM) のサービス名とトレース ID 🔗
Splunk APM でグローバル・データリンクにアクセスする方法の詳細については、APMのサービス、トレース、スパンにリンクされた関連リソースにアクセスする を参照してください。
次のステップ 🔗
Splunk Application Performance Monitoring (APM) プロパティのグローバル・データリンクを作成する方法については、APMのサービス、トレース、スパンを関連リソースにリンクする を参照してください。
プロパティに対して複数のデータリンクが利用可能な場合のデータリンクの動作については、プロパティの値を選択してリンクをたどる を参照してください。