プライベートロケーションコンフィギュレーション
Dash が新機能を発表!インシデントマネジメント、Continuous Profiler など多数の機能が追加されました! Dash イベントで発表された新機能!

プライベートロケーションコンフィギュレーション

概要

Synthetic プライベートロケーションには、環境要件に合わせて構成できる一連のオプションが付属しています。これらのオプションはすべて、以下の help コマンドを実行すると確認できます。

docker run --rm datadog/synthetics-private-location-worker --help

次に、プライベートロケーションのコンフィギュレーションオプションをパラメーターとして JSON コンフィギュレーションファイルに渡すか、以下のように起動コマンドの引数として渡すことができます。

docker run --rm -v $PWD/<MY_WORKER_CONFIG_FILE_NAME>.json:/etc/datadog/synthetics-check-runner.json datadog/synthetics-private-location-worker:latest --logFormat=json

注: 起動コマンドで設定された引数は、コンフィギュレーションファイルよりも優先されます。ただし、これらのオプションは保存されないため、特定の起動でのみ使用されます。

構成オプション

Datadog サイトコンフィギュレーション

オプションタイプデフォルト説明
site文字列datadoghq.comプライベートロケーションがテストコンフィギュレーションをプルし、テスト結果をプッシュする Datadog サイト。Datadog EU ユーザーの場合は、datadoghq.eu に設定する必要があります。

DNS コンフィギュレーション

オプションタイプデフォルト説明
dnsUseHostBooleantrue最初にホストのローカル DNS コンフィギュレーション (たとえば、etc/resolv.conf ファイルのコンフィギュレーション) を使用し、次に DNS サーバーがある場合は、dnsServer パラメーターで指定します。
dnsServer文字列の配列["8.8.8.8","1.1.1.1"]指定した順序で使用する DNS サーバーの IP (例: --dnsServer="8.8.4.4" --dnsServer="8.8.8.8")。

予約済み IP コンフィギュレーション

オプションタイプデフォルト説明
enableDefaultBlockedIpRangesBooleanfalseallowedIPRanges パラメーターで明示的に設定されていない限り、ユーザーが予約済み IP 範囲 (IANA IPv4 および IPv6 専用アドレスレジストリ) を使用しているエンドポイントで Synthetic テストを作成できないようにします。
allowedIPRanges文字列の配列noneenableDefaultBlockedIpRanges または blockedIPRanges によってブロックされた IP 範囲のうち、特定の IP または CIDR あるいはその両方へのアクセスを許可します (例: "allowedIPRanges.4": "10.0.0.0/8")。注: allowedIPRangesblockedIPRanges よりも優先されます。
blockedIPRanges文字列の配列noneenableDefaultBlockedIpRanges パラメーターを true に設定すると、ブロックされた IP 範囲に加えて、特定の IP または CIDR あるいはその両方へのアクセスをブロックします (例: --blockedIPRanges.4="127.0.0.0/8" --blockedIPRanges.6="::1/128".)

注: whitelistedRange および blacklistedRange パラメーターは非推奨になったため、上記のパラメーターに置き換える必要があります。

プロキシコンフィギュレーション

オプションタイプデフォルト説明
proxyDatadog文字列noneDatadog にリクエストを送信するためにプライベートロケーションで使用されるプロキシ URL (例: --proxyDatadog=http://<YOUR_USER>:<YOUR_PWD>@<YOUR_IP>:<YOUR_PORT>)。
proxyTestRequests文字列noneエンドポイントにテストリクエストを送信するためにプライベートロケーションで使用されるプロキシ URL。
proxyIgnoreSSLErrorsBooleanfalseプライベートロケーションがプロキシを使用して Datadog にリクエストを送信している場合は、SSL エラーを破棄します。

注: proxy パラメーターは非推奨になったため、proxyDatadog に置き換える必要があります。

高度なコンフィギュレーション

オプションタイプデフォルト説明
concurrency数値10並列で実行されるテストの最大数。
maxTimeout数値60000API テストのテストの最大実行時間 (ミリ秒)。

プライベートロケーション管理者

オプションタイプデフォルト説明
logFormat文字列pretty"pretty""json" 間でログ出力をフォーマットします。ログフォーマットを json に設定すると、ログが Datadog によって収集された時点で自動的に解析できます。
verbosity数値3冗長レベル (例: -v, -vv, -vvv, …)。
dumpConfigBooleannoneシークレットなしでワーカーコンフィギュレーションパラメーターを表示します。
dumpFullConfigBooleannone完全なワーカーコンフィギュレーションパラメーターを表示します。
helpBooleannoneヘルプを表示します。

その他の参考資料