グローバル変数

Splunk Synthetic Monitoring の複数のブラウザおよび API テストで使用できる変数を定義します。

グローバル変数は、事前に保存済みかつ再利用可能な変数であり、一度定義すれば、すべてのブラウザテストとAPIテストで使用できます。

グローバル変数はどのように使用できますか？

グローバル変数は、ブラウザテストや API テストで情報を保存するために使用します。Splunk Synthetics はグローバル変数を保存しますが、その値を非表示にしない場合は、アカウント内のすべてのユーザーに表示されることに注意してください。

注: アカウントのセキュリティを維持するために、クレジットカード情報や健康情報など、規制対象のデータを保存するためにグローバル変数を使用しないでください。

認証ワークフローのテストを行う際は、変数を保存する前に非表示に設定してください。

グローバル変数を隠すとどうなりますか？

グローバル変数を隠すと、Splunk Synthetics はデータベース内の変数の値を暗号化し、Splunk Synthetics の UI、テスト結果、およびアラートメッセージからその値をスクラビング処理します。ただし、隠されたグローバル変数は、機密情報や重要なデータを保護するように設計されていません。そのような目的のために誤って使用しないでください。

グローバル変数を作成する

グローバル変数を作成するには2つの方法があります：

  • ボールトに新しいグローバル変数を追加する：

    1. Splunk Synthetics ランディングページで、設定アイコンを選択し、[Global variables] を選択します。[Synthetics configuration] ページが開き、[Global variables] タブが表示されます。

    2. Create variable を選択します。

  • テストの編集中に新しいグローバル変数を追加する：

    1. 右側のVariablesペインを展開します。

    2. Add を選択します。

[Add variable] ダイアログボックスで、次のように入力します。

  1. Variable type を Environment に設定します。

  2. [env] フィールドに変数の名前を入力します。このキーを使用して、テスト内で変数にアクセスします。

  3. value フィールドに、テスト実行時に変数を置き換える値を入力します。

  4. （オプション）[Description] フィールドに、後で参照するために変数の目的を説明する文を入力します。説明は、変数を隠してその値を明らかにできない場合に特に役立ちます。

  5. （オプション）Conceal valueを選択します。

  6. Add を選択します。

グローバル変数を編集する

グローバル変数のキーまたは説明を編集するには、[Global variables] ページにアクセスし、フィールド内で編集します。編集が終わったら、[Save] を選択します。

保存された隠しグローバル変数の値を編集すると、以前の値はクリアされます。新しい値を指定し、[Save] を選択して適用する必要があります。

合成テストでグローバル変数を使用する

グローバル変数を使用して、ブラウザテストの [Steps] や [synthetic transactions] のフィールド、あるいは API テストのリクエストのフィールドを埋めることができます。グローバル変数は Cookie では使用できません。

テストの作成または編集中に、右側の [Variables] タブに、使用できる組み込み変数とグローバル変数のリストが表示されます。変数名を選択すると、キーボードにコピーされます。

ブラウザテストでグローバル変数を使用する

以下の手順に従って、ブラウザテストに変数を追加してください：

  1. トランザクションブラウザテストの作成または編集中に、Steps に移動します。

  2. Action で、ドロップダウンメニューから Fill in field を選択します。

  3. [Value] に、使用したいグローバル変数のキーを入力します。先頭に env. を付けて、二重中括弧で囲みます。たとえば、キーが dev-usernameであるグローバル変数を使用するには、[Value] フィールドに{{env.dev-username}}と入力します。

  4. テストの編集または作成を終了します。

  5. テストを Save します。

API テストでグローバル変数を使用する

グローバル変数を使用して、API テストのフィールドに入力することもできます。たとえば、グローバル変数を使って、リクエストの URL やヘッダー値、その他の値を指定することができます。

以下の手順に従って、APIテストに変数を追加してください：

  1. APIテストを作成または編集している間に、Requests に移動します。

  2. セットアップ、リクエスト、または検証ステップの変数フィールドに、使用したいグローバル変数のキーを入力します。このとき先頭に env. を付けて、二重中括弧で囲みます。たとえば、キーが staging-url のグローバル変数を使用するには、フィールドに {{env.staging-url}} と入力します。

  3. テストの編集または作成を終了します。

  4. テストを Save します。