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 작업에 구성된 프로브 주기와 같습니다.