Tencent Cloud CAT¶
Tencent Cloud CAT のタスクオブジェクトとプローブメトリクスを収集します.
設定¶
Func のインストール¶
Guance のインテグレーション - 拡張からホスト型 Func を有効にすることをお勧めします.前提条件は自動的にインストールされます.
Func を独自にデプロイする場合は, Func の独自デプロイ.
スクリプトのインストール¶
事前準備
- アクセスキーの作成: Tencent Cloud の
Cloud Access Managementで, 収集に使用するサブユーザーの API キーを作成し,SecretIdとSecretKeyを保存します. - 権限の設定: API キーを所有する CAM サブユーザーにグローバルプリセットポリシー
ReadOnlyAccessを付与します.最小権限のカスタムポリシーを使用する場合は,cat:DescribeProbeTasksとcat: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 スクリプトセットを作成し, 対応する起動スクリプトを自動設定します.
有効化すると, 管理 / 自動トリガー設定で対応する設定を確認できます.実行をクリックすると, スケジュールを待たずに即時実行できます.しばらくすると, 実行履歴とログを確認できます.
検証¶
- 管理 / 自動トリガー設定で対象タスクの自動トリガー設定が存在することを確認し, タスク履歴とログに異常がないか確認します.
- Guance のインフラストラクチャ / カスタムでオブジェクトデータを確認します:
tencentcloud_cat_task. - 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 |
Tip
メトリクスポイントの間隔は, Tencent Cloud CAT タスクに設定されたプローブ頻度と一致します.