Terraformファイルを使用してSplunk AppDynamics階層にグローバルデータリンクを作成する 🔗

注釈

Splunk APM推定サービスから Splunk AppDynamics階層へのグローバルデータリンクを作成できるのは、その階層がSplunk AppDynamics SaaS環境で監視されている場合のみです。

このメソッドは、既存のグローバルデータリンクを持たない推定サービスのグローバルデータリンクを作成するためにのみ使用できます。推定サービスがすでに既存のグローバルデータリンクを持っている場合は、UI を使用して追加のグローバルデータリンクを作成します。

トランザクションがSplunk APMが監視するサービスとSplunk AppDynamicsが監視する階層を経由する場合、Splunk APMが監視するサービスは推定サービスとみなされます。

グローバルデータリンクを作成して、Splunk APM推定サービスをSplunk AppDynamics階層にリンクします。Splunk APMで推定サービスを表示すると、データリンクを選択してSplunk AppDynamicsユーザーインターフェイスで階層に移動できます。

Terraform設定ファイルを使用して、Splunk AppDynamics階層へのグローバルデータリンクをプログラムで作成できます。

前提条件 🔗

Node.jsスクリプトを使用してSplunk AppDynamics階層にグローバルデータリンクを作成するには、以下の手順が必要です：

管理者のロールを持つSplunk Observability Cloudアカウント。
Terraformの最新バージョン。

Terraform設定ファイルでデータリンクを作成する 🔗

Terraformの設定ファイルでデータリンクを作成するには：

Terraformディレクトリに、以下の内容の<ファイル名>.tfというTerraform設定ファイルを作成します：

# Specify the Terraform provider and version
terraform {
required_providers {
    signalfx = {
    source  = "splunk-terraform/signalfx"
    version = "~> <current-splunk-terraform-provider-version>"
    }
}
}

# The following variable blocks can also be located in a variables.tf file in the same directory
variable "signalfx_auth_token" {
description = "The user API access authentication token for your org"
type        = string
default     = ""
}
variable "signalfx_api_url" {
description = "The API URL of your org"
type        = string
default     = ""
}

# Configure the Splunk Observability Cloud provider
provider "signalfx" {
auth_token = "${var.signalfx_auth_token}"
api_url = "${var.signalfx_api_url}"
}

version には、現在の Splunk Observability Cloud Terraformプロバイダーのバージョンを入力します。最新バージョンを確認するには、リリースを参照してください。この値は9.6.0以上である必要があります。
(オプション) 設定に必要な引数を追加します。サポートされている引数の詳細については、Terraformドキュメントの Splunk Observability Cloudプロバイダーを参照してください。

signalfx_data_link リソースをTerraformファイルに追加します：
# A link to a Splunk AppDynamics service resource "signalfx_data_link" "<data-link-id>" { property_name = "sf_service" property_value = "<splunk-inferred-service-name>" target_appd_url { name = "<data-link-ui-label>" url = "<https://www.example.saas.appdynamics.com/#/application=1234&component=5678>" } }
- <data-link-id>にはデータリンクの識別子を入力します。この値はTerraformファイルでのみ表示され、データリンクごとに一意である必要があります。例えば、my_data_link_appd_1やmy_data_link_appd_2を使うことができます。
- property_name には、sf_service を使用します。
- property_value には、Splunk APM推定サービス名を入力します。
- name の場合、データリンクのラベルを入力します。このラベルはSplunk Observability Cloudのユーザーインターフェイスに表示されます。
- URL には、Splunk AppDynamics階層のURLを入力します。
  階層のURLを取得するには、Splunk AppDynamics UIで階層に移動し、ブラウザからURLをコピーします。URL全体をキャプチャし、コントローラURL、アプリケーションID、アプリケーションコンポーネントが含まれていることを確認します。

作成するSplunk AppDynamics階層へのデータリンクごとに前の手順を繰り返します。以下の例では、Splunk AppDynamics階層への複数のデータリンクを持つTerraform設定ファイルを表示しています：

# Specify the Terraform provider and version
terraform {
required_providers {
    signalfx = {
    source  = "splunk-terraform/signalfx"
    version = "~> 9.6.0"
    }
}
}

# The following variable blocks can also be located in the variables.tf file in the same directory
variable "signalfx_auth_token" {
description = "The user API access auth token for your org"
type        = string
default     = ""
}
variable "signalfx_api_url" {
description = "The API URL of your org"
type        = string
default     = ""
}

# Configure the Splunk Observability Cloud provider
provider "signalfx" {
auth_token = "${var.signalfx_auth_token}"
api_url    = "${var.signalfx_api_url}"
}
# If your organization uses a custom URL, replace api_url with:
# custom_app_url = "https://myorg.signalfx.com"

# A link to a Splunk AppDynamics service
resource "signalfx_data_link" "my_data_link_appd_1" {
property_name        = "sf_service"
property_value       = "placed_orders"

target_appd_url {
    name        = "appd_url_placed_orders"
    url         = "https://www.example.saas.appdynamics.com/#/application=1234&component=5678"
}
}

# A link to a Splunk AppDynamics service
resource "signalfx_data_link" "my_data_link_appd_2" {
property_name        = "sf_service"
property_value       = "returned_orders"

target_appd_url {
    name        = "appd_url_returned_orders"
    url         = "https://www.example.saas.appdynamics.com/#/application=4321&component=8765"
}
}

Terraform設定ファイルのある作業ディレクトリで、以下のコマンドを実行してディレクトリを初期化します：
terraform init
signalfx_auth_tokenとsignalfx_api_url変数を設定し、Terraformが行う変更のプレビューを生成するには、以下を実行します：
terraform plan -var="signalfx_auth_token=<api-access-token>" -var="signalfx_api_url=https://api.<realm>.signalfx.com" -out=<plan-file-name>
- <api-access-token> には、Splunk Observability Cloud APIアクセストークンを入力します。これを取得するには、Splunk Observabilityに移動し、ヘッダーでプロファイルを選択します。My Profile を選択し、次に Show User API Access Token を選択し、APIアクセストークンをコピーします。
- <realm> には、Splunk Observability Cloudのレルムを入力します。レルムを取得するには、Splunk Observability Cloudに移動し、ヘッダーでプロファイルを選択します。My Profile を選択し、次に Organizations を選択して、Realm をコピーします。
- <plan-file-name>には、Terraformが変更のために作成するプランファイルの名前を入力します。
出力を使って変更を確認します。変更を実行し、Terraformが作成したリソースをリストしたterraform.tf.stateファイルを作成します：
terraform apply "<plan-file-name>"
グローバルデータリンクが正常に作成されたことを確認するには、以下のいずれかの方法を使用します：
- コマンドの出力を表示します。正常に実行された場合の出力例： Apply complete! Resources: 3 added, 0 changed, 0 destroyed。
- Terraformディレクトリにあるterraform.tfstateファイルを表示します。このファイルには作成されたリソースのリストが含まれています。
- UIでグローバルデータのリンクを表示します。Splunk Observability Cloudのメインメニューで、Settings を選択し、Global Data Link を選択します。Terraformファイルで指定したデータリンク名のページを検索します。

次のステップ 🔗

ユーザーインターフェイスでグローバルデータリンクにアクセスするには、サービスのグローバルデータリンクにアクセスするを参照してください。

Terraform を使用してすべてのグローバルデータリンクを削除するには、Terraformですべてのグローバルデータリンクを削除するを参照してください。

このページは 2025年02月03日に最終更新されました。

Related Topics

Terraformファイルを使用してSplunk AppDynamics階層にグローバルデータリンクを作成する 🔗

前提条件 🔗

Terraform設定ファイルでデータリンクを作成する 🔗

次のステップ 🔗

Was this topic useful?

Splunk

Related Topics