コンテンツにスキップ

Tencent Cloud CAT

Tencent Cloud CAT のタスクオブジェクトとプローブメトリクスを収集します.

設定

Func のインストール

Guance のインテグレーション - 拡張からホスト型 Func を有効にすることをお勧めします.前提条件は自動的にインストールされます.

Func を独自にデプロイする場合は, Func の独自デプロイ.

スクリプトのインストール

事前準備

  • アクセスキーの作成: Tencent Cloud の Cloud Access Management で, 収集に使用するサブユーザーの API キーを作成し, SecretIdSecretKey を保存します.
  • 権限の設定: API キーを所有する CAM サブユーザーにグローバルプリセットポリシー ReadOnlyAccess を付与します.最小権限のカスタムポリシーを使用する場合は, cat:DescribeProbeTaskscat:DescribeProbeMetricData を許可します.

DataFlux Func スクリプトマーケットから, 次のコレクターをインストールします.

  • Integration (TencentCloud-CAT Collector) (スクリプトセット ID: integration_tencentcloud_cat).CAT タスクオブジェクトを収集し, タスクオブジェクトとメトリクスの収集を開始できます.
  • Integration (TencentCloud-CAT Metric Collector) (スクリプトセット ID: integration_tencentcloud_cat_metric).CAT メトリクスデータを収集します.

インストールをクリックし, 次のパラメーターを入力します.

  • TencentCloud SecretId: Tencent Cloud アクセスキー ID (必須).
  • TencentCloud SecretKey: Tencent Cloud アクセスキー Secret (必須).
  • Your Account Name: 任意のアカウント名 (任意).

CAT タスク自体はリージョン別ではないため, コレクターでリージョンを設定する必要はありません.

起動スクリプトをデプロイをクリックします.システムが Startup スクリプトセットを作成し, 対応する起動スクリプトを自動設定します.

有効化すると, 管理 / 自動トリガー設定で対応する設定を確認できます.実行をクリックすると, スケジュールを待たずに即時実行できます.しばらくすると, 実行履歴とログを確認できます.

検証

  1. 管理 / 自動トリガー設定で対象タスクの自動トリガー設定が存在することを確認し, タスク履歴とログに異常がないか確認します.
  2. Guance のインフラストラクチャ / カスタムでオブジェクトデータを確認します: tencentcloud_cat_task.
  3. Guance のメトリクスで対応する measurement を確認します: tencentcloud_cat_browse, tencentcloud_cat_network, tencentcloud_cat_transport, tencentcloud_cat_upload_download, tencentcloud_cat_media_stream, tencentcloud_cat_whois.

メトリクス

CAT はタスクタイプに応じて異なる measurement にデータを書き込みます.

タスクタイプ measurement
ページパフォーマンス tencentcloud_cat_browse
ネットワーク品質 tencentcloud_cat_network
ポートパフォーマンス tencentcloud_cat_transport
ファイル転送 tencentcloud_cat_upload_download
音声・動画体験 tencentcloud_cat_media_stream
ドメイン Whois tencentcloud_cat_whois

共通タグ

次の共通タグはメトリクスコレクターによって保持されます.タグ名は Guance に書き込まれる名前で, 小文字の snake_case 形式です.

フィールド 説明
area プローブノードのリージョン
area_id プローブノードのリージョン ID
city プローブノードの都市
city_code プローブノードの都市コード
cloud_provider クラウドプロバイダー識別子, 固定値は tencentcloud
destination_city_name 宛先都市名 (ファイル転送タスクで返される場合があります)
distinct プローブノードのリージョン表示名
error_id エラー ID
error_info エラー情報
operator プローブノードのキャリア
operator_id プローブノードのキャリア ID
probe_app_id プローブアプリケーション ID
probe_nodes_code プローブノードコード
target_address プローブ対象アドレス
task_category プローブタスクカテゴリー
task_id プローブタスク ID
task_name プローブタスク名
task_type プローブタスクタイプ
task_type_name プローブタスクタイプ名
type アップロード/ダウンロード種別 (ファイル転送タスクで返される場合があります)

メトリクスデータの host は, Guance の組み込み host タグとの競合を避けるため, タグとして書き込みません.タスク名には tencentcloud_cat_task オブジェクトが補完する task_name を使用します.

Measurement

tencentcloud_cat_browse

生メトリクス

metricName description unit
average_dns_query_time 平均 DNS クエリ時間 ms
average_download_time 平均ダウンロード所要時間 ms
average_request_time 平均リクエスト所要時間 μs
average_response_time 平均レスポンス所要時間 ms
average_ssl_time 平均 SSL ハンドシェイク所要時間 ms
average_tcp_connection_time 平均 TCP 接続所要時間 ms
block_projection_time ブロックフェーズ推定所要時間 参照なし
bytes_received 受信バイト数 B
count プローブ合計回数 count
d_time ページ全体読み込み所要時間 ms
dns_error_count DNS エラー回数 count
dns_look_up DNS クエリ所要時間 ms
dns_query_time DNS クエリ所要時間 ms
document_finish_time Document 完了所要時間 ms
dom_load_time DOM 読み込み所要時間 ms
element_hijack_count 要素ハイジャック回数 count
err_ele_count エラー要素数 count
error_count プローブ失敗回数 count
file_download_size ダウンロードファイルサイズ B
file_download_speed ファイルダウンロード速度 参照なし
file_download_time ファイルダウンロード所要時間 ms
first_ele_all_num ファーストビュー要素数 count
first_err_ele_num ファーストビューエラー要素数 count
first_full_time 初回完全読み込み所要時間 ms
first_packet_arrival_time 最初のパケット到着所要時間 ms
first_screen_time ファーストビュー所要時間 ms
hijack_302_count 302 ハイジャック回数 count
hijack_302_success_count 302 ハイジャック成功回数 count
hijack_count ハイジャック回数 count
hijack_error_count ハイジャックエラー回数 count
hijack_normal_count 正常ハイジャック回数 count
hijack_third_count サードパーティーハイジャック回数 count
host_hijack_count Host ハイジャック回数 count
http_error_count HTTP エラー回数 count
k100_time 100 KB ダウンロード所要時間 ms
onload_time Window onload 所要時間 ms
overall_download_speed 全体ダウンロード速度 KB/s
page_3xx_num ページ 3xx 遷移回数 count
page_start_render ページレンダリング開始所要時間 ms
projection_dns_query_time DNS クエリ推定所要時間 参照なし
projection_download_time ダウンロード推定所要時間 参照なし
projection_request_time リクエスト推定所要時間 参照なし
projection_response_time レスポンス推定所要時間 参照なし
projection_ssl_time SSL 推定所要時間 参照なし
projection_tcp_connection_time TCP 接続推定所要時間 参照なし
redirect_count リダイレクト回数 count
redirect_time リダイレクト所要時間 ms
render_speed レンダリング速度 参照なし
render_time レンダリング所要時間 ms
request_time リクエスト所要時間 ms
response_time レスポンス所要時間 ms
round_trips 往復回数 count
slow_count 低速プローブ回数 count
ssl_error_count SSL エラー回数 count
ssl_time SSL ハンドシェイク所要時間 ms
success_count プローブ成功回数 count
tcp_connection_time TCP 接続所要時間 ms
tcp_connects TCP 接続回数 count
tcp_error_count TCP エラー回数 count
trans_error_count 転送エラー回数 count

計算メトリクス

次のメトリクスは, 同一プローブサイクルの生メトリクスを集計して算出し, ページパフォーマンスの転送速度と成功率を表示します.ディメンションは task_id, area, city, operator, probe_nodes_code.

metricName description unit
overall_transfer_speed 全体転送速度, 式: (sum("bytes_received") / 1024) / (sum("d_time") / 1000) KB/s
success_rate プローブ成功率, 式: sum("success_count") / sum("count") * 100 percent

Measurement

tencentcloud_cat_network

生メトリクス

metricName description unit
count プローブ合計回数 count
dig_error_count DNS 解決エラー回数 count
dig_success_count DNS 解決成功回数 count
error_count プローブ失敗回数 count
hijack_count ハイジャック回数 count
ping_count Ping パケット数 count
ping_drop_package_count Ping パケットロス数 count
ping_drop_package_percent Ping パケットロス割合 参照なし
ping_error_count Ping エラー回数 count
ping_success_count Ping 成功回数 count
ping_time Ping レイテンシ ms
ping_timeout_num Ping タイムアウト回数 count
query_time DNS クエリ所要時間 ms
success_count プローブ成功回数 count
tracert_avg_time 平均 Tracert レイテンシ ms
tracert_error_count Tracert エラー回数 count
tracert_skip_count Tracert スキップ回数 count
tracert_success_count Tracert 成功回数 count
ttl_time TTL 値 s

計算メトリクス

次のメトリクスは, 同一プローブサイクルの生メトリクスを集計して算出し, ネットワークプローブの総所要時間, 成功率, DNS 解決成功率, Ping パケットロス率などを表示します.ディメンションは task_id, area, city, operator, probe_nodes_code.

metricName description unit
dns_error_rate DNS 解決エラー率, 式: sum("dig_error_count") / (sum("dig_success_count") + sum("dig_error_count")) * 100 percent
dns_success_rate DNS 解決成功率, 式: sum("dig_success_count") / (sum("dig_success_count") + sum("dig_error_count")) * 100 percent
packet_loss_rate Ping パケットロス率, 式: sum("ping_drop_package_count") / sum("ping_count") * 100 percent
ping_success_rate Ping 成功率, 式: sum("ping_success_count") / (sum("ping_success_count") + sum("ping_error_count")) * 100 percent
success_rate プローブ成功率, 式: sum("success_count") / (sum("success_count") + sum("error_count")) * 100 percent
total_time ネットワーク品質全体所要時間, 式: avg("query_time") + avg("ping_time") ms

Measurement

tencentcloud_cat_transport

生メトリクス

metricName description unit
avg_error_rate 平均エラー率 参照なし
client_net_speed クライアントネットワーク速度 参照なし
connection_time 接続所要時間 ms
count プローブ合計回数 count
d_time 全体所要時間 ms
dns_error_count DNS エラー回数 count
dns_time DNS 解決所要時間 ms
error_count プローブ失敗回数 count
max_time 最大所要時間 ms
min_time 最小所要時間 ms
request_time リクエスト所要時間 ms
response_time レスポンス所要時間 ms
send_true_package_num 成功送信パケット数 count
ssl_error_count SSL エラー回数 count
ssl_time SSL ハンドシェイク所要時間 ms
success_count プローブ成功回数 count
tcp_error_count TCP エラー回数 count
trans_error_count 転送エラー回数 count
verify_error_rate 検証エラー率 参照なし
wait_time 待機所要時間 ms

計算メトリクス

次のメトリクスは, 同一プローブサイクルの生メトリクスを集計して算出し, ポートプローブと検証の成功率を表示します.ディメンションは task_id, area, city, operator, probe_nodes_code.

metricName description unit
success_rate プローブ成功率, 式: sum("success_count") / (sum("success_count") + sum("error_count")) * 100 percent
verify_success_rate 検証成功率, 式: (1 - sum("verify_error_rate") / (sum("verify_error_rate") + (sum("success_count") * 100))) * 100 percent

Measurement

tencentcloud_cat_upload_download

生メトリクス

metricName description unit
avg_speed 平均転送速度 参照なし
count プローブ合計回数 count
dns_time DNS 解決所要時間 ms
error_count プローブ失敗回数 count
file_size ファイルサイズ B
first_package_time 最初のパケット所要時間 ms
hijack_count ハイジャック回数 count
host_hijack_count Host ハイジャック回数 count
rec_time 受信所要時間 ms
redirect_count リダイレクト回数 count
redirect_times リダイレクト回数 count
response_time レスポンス所要時間 ms
send_time 送信所要時間 ms
slow_count 低速プローブ回数 count
ssl_time SSL ハンドシェイク所要時間 ms
success_count プローブ成功回数 count
tcp_time TCP 接続所要時間 ms
total_time 合計転送所要時間 ms
transfer_time 転送所要時間 ms

計算メトリクス

次のメトリクスは, 同一プローブサイクルの生メトリクスを集計して算出し, ファイルアップロードまたはダウンロードタスクの成功率を表示します.ディメンションは task_id, area, city, operator, probe_nodes_code, type.

metricName description unit
success_rate ファイル転送成功率, 式: sum("success_count") / sum("count") * 100 percent

Measurement

tencentcloud_cat_media_stream

生メトリクス

metricName description unit
audio_rate 音声ビットレート 参照なし
avg_down_speed 平均ダウンロード速度 参照なし
buffer_num バッファリング回数 count
caton_flag 停止フラグ 参照なし
caton_number 停止回数 count
caton_rate 停止率 参照なし
caton_time 停止時間 ms
client_net_speed クライアントネットワーク速度 参照なし
connect_time 接続所要時間 ms
connecting_time 接続確立所要時間 ms
count プローブ合計回数 count
dns_resolution_time DNS 解決所要時間 ms
download_size ダウンロードサイズ B
error_count プローブ失敗回数 count
first_buffer_time 初回バッファリング所要時間 ms
first_down_size 初回ダウンロードサイズ B
first_down_speed 初回ダウンロード速度 参照なし
first_duration_time 初回再生時間 参照なし
first_frame 最初のフレーム所要時間 ms
first_plag_time 初回再生停止所要時間 参照なし
fps フレームレート 参照なし
hijack_count ハイジャック回数 count
hijack_domain_count ドメインハイジャック回数 count
page_first_time ページ先頭バイト所要時間 ms
page_one_byte_time ページ単一バイト所要時間 参照なし
resource_ssl リソース SSL 所要時間 参照なし
response_time レスポンス所要時間 ms
slow_count 低速プローブ回数 count
success_count プローブ成功回数 count
total_buffer_time 合計バッファリング時間 ms
total_down_time 合計ダウンロード所要時間 ms
total_plag_time 合計再生停止所要時間 参照なし
video_rate 動画ビットレート 参照なし
wait_rate 待機率 参照なし

計算メトリクス

次のメトリクスは, 同一プローブサイクルの生メトリクスを集計して算出し, 音声・動画プローブの成功率を表示します.ディメンションは task_id, area, city, operator, probe_nodes_code.

metricName description unit
success_rate 音声・動画プローブ成功率, 式: sum("success_count") / (sum("success_count") + sum("error_count")) * 100 percent

Measurement

tencentcloud_cat_whois

生メトリクス

metricName description unit
count プローブ合計回数 count
error_count プローブ失敗回数 count
success_count プローブ成功回数 count
Tip

メトリクスポイントの間隔は, Tencent Cloud CAT タスクに設定されたプローブ頻度と一致します.

フィードバック

このページは役に立ちましたか?