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

Docs > Synthetic の監視 > Synthetic テストをプライベートロケーションから実行する > プライベートロケーションコンフィギュレーション

概要

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 サイト。site はです。

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

以下のパラメーターは API テストで DNS 解決をカスタマイズするために使用されます。

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

ブラウザテストの場合、DNS 解決はブラウザにより直接行われ、ホストから DNS サーバーが読み込まれます。また、コンテナレベルでこの構成を行うこともできます (例: Docker の --dns フラグ、または Kubernetes の dnsConfig.nameservers を使用する) 。

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

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

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

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

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

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

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

concurrency: 種類: 数字
デフォルト: 10
並列で実行されるテストの最大数。
maxNumberMessagesToFetch: タイプ: 数字
デフォルト: 10
Datadog から取得されるテストの最大数。
enableStatusProbes: タイプ: ブール値
プライベートロケーションプローブの readiness と liveness を有効にします。これにより 2 つのエンドポイント、http://127.0.0.1:8080/liveness と http://127.0.0.1:8080/readiness が有効になります。
statusProbesPort: タイプ: 数字
デフォルト: 8080
プライベートロケーションステータスプローブのポートを上書きします。
variableOverride: タイプ: 文字列
プライベートロケーションで実行されるテストで使用される変数をオーバーライドします。形式: VARIABLE=value この方法でインポートされた変数は、すべて難読化されます。
environmentVariableOverride: タイプ: 文字列
プライベートロケーションで実行するテストで使用する変数を、環境変数でオーバーライドします。コンテナ環境で環境変数がインポートされていることが必要です。 Docker の場合、例えば docker run --env VARIABLE gcr.io/datadoghq/synthetics-private-location-worker --environmentVariableOverride VARIABLE のようにします。この方法でインポートされた変数は、すべて難読化されます。

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

config: タイプ: 文字列
デフォルト: /etc/datadog/synthetics-check-runner.json
JSON コンフィギュレーションファイルへのパス。
logFormat: タイプ: 文字列
デフォルト: pretty
"pretty" と "json" 間でログ出力をフォーマットします。ログフォーマットを json に設定すると、ログが Datadog によって収集された時点で自動的に解析できます。
verbosity: タイプ: 数字
デフォルト: 3
冗長レベル (例: -v、-vv、-vvv)。
dumpConfig: 種類: ブール値
デフォルト: none
シークレットなしでワーカーコンフィギュレーションパラメーターを表示します。
help: タイプ: ブール値
デフォルト: none
ヘルプを表示します。