Supported OS
任意のホストおよびポートの TCP 接続と応答時間を監視します。
TCP チェックは Datadog Agent パッケージに含まれているため、TCP ポートを調査するホストに追加で何かをインストールする必要はありません。メトリクス指向チェックの多くは監視対象サービスと同じホストで実行することが最適な実行方法ですが、リモート接続をテストする場合などに、監視対象の TCP サービスを実行していないホストからこのチェックを実行する方が望ましい場合があります。
ホストで実行中の Agent に対してこのチェックを構成するには:
Agent のコンフィギュレーションディレクトリのルートにある conf.d/ フォルダーの tcp_check.d/conf.yaml ファイルを編集します。使用可能なすべてのコンフィギュレーションオプションの詳細については、サンプル tcp_check.d/conf.yaml を参照してください。
init_config:
instances:
- name: SSH check
host: jumphost.example.com # または IPv4/IPv6 アドレス
port: 22
collect_response_time: true # network.tcp.response_time を収集します。デフォルトは false です。
構成オプション
name (必須) - サービスの名前。これは、タグ instance:<name> で指定します。注: このタグでは、すべてのスペースおよびダッシュがアンダースコアに変換されます。host (必須) - チェックするホスト。これは、タグ url:<host>:<port> で指定します。port (必須) - チェックするポート。これは、タグ url:<host>:<port> で指定します。timeout (オプション) - チェックのタイムアウト。デフォルトは 10 秒です。collect_response_time (オプション) - デフォルトは false。このオプションを true に設定しなかった場合、応答時間メトリクスは収集されません。これを true に設定した場合は、メトリクス network.tcp.response_time が返されます。tags (オプション) - メトリクスに割り当てるタグ。Agent を再起動すると、Datadog への TCP サービスチェックと応答時間の送信が開始されます。
コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照して、次のパラメーターを適用してください。
| パラメーター | 値 |
|---|---|
<インテグレーション名> | tcp_check |
<初期コンフィギュレーション> | 空白または {} |
<インスタンスコンフィギュレーション> | {"name": "<TCP_CHECK_INSTANCE_NAME>", "host":"%%host%%", "port":"%%port%%"} |
Agent の status サブコマンドを実行し、Checks セクションで tcp_check を探します。
| network.tcp.response_time (gauge) | The response time of a given host and TCP port, tagged with url, e.g. 'url:192.168.1.100:22'. Shown as second |
| network.tcp.can_connect (gauge) | Value of 1 if the agent can successfully establish a connection to the URL, 0 otherwise |
TCP チェックには、イベントは含まれません。
tcp.can_connect
Returns CRITICAL if the Agent cannot establish an TCP connection to the URL. Returns OK if the connection is successful.
Statuses: ok, critical
ご不明な点は、Datadog のサポートチームまでお問合せください。