IMCP 테스트를 사용하면 호스트 사용량을 모니터링하고 네트워크 통신 문제를 진단할 수 있습니다. ICMP Ping 하나나 두 개에서 받은 값을 엔드포인트에 어설션하면 Datadog에서 연결 문제, 지정 시간보다 긴 왕복 대기 시간, 보안 방화벽 구성 내 예상치 못한 변경 사항 등을 감지할 수 있습니다. 또 호스트에 연결하는 데 필요한 네트워크 홉(TTL) 수를 추적할 수 있고, 추적 경로를 확인하여 각 네트워크 홉과 경로의 상세 정보를 찾을 수 있습니다.
ICMP Ping을 외부에서 트리거하느냐 혹은 네트워크 내부에서 트리거하느냐에 따라 ICMP 테스트를 [관리형]](#select-locations)과 프라이빗 위치에서 실행할 수 있습니다. 정의한 일정에 따라 ICMP 테스트를 실행하거나 온디맨드로 실행할 수 있고, 또는 CI/CD 파이프라인 내에서 실행할 수도 있습니다.
설정
다음 옵션 중 하나를 사용하여 테스트를 생성할 수 있습니다.
템플릿에서 테스트 생성하기:
사전에 채워진 템플릿 중 하나에 마우스를 올리고 템플릿 보기를 클릭합니다. 테스트 세부 정보, 요청 세부 정보, 어설션, 알림 조건 및 모니터링 설정이 포함된, 사전에 채워진 설정 정보가 표시되는 사이드 패널이 열립니다.
+테스트 생성하기를 클릭하면 사전 입력된 설정 옵션을 검토하고 편집할 수 있는 요청 정의 페이지가 열립니다. 표시되는 필드는 테스트 초기 생성 시사용할 수 있는 필드와 동일합니다.
세부 정보 저장을 클릭하여 API 테스트를 제출합니다.
테스트 처음부터 빌드하기:
테스트를 처음부터 빌드하려면 +처음부터 시작 템플릿을 클릭한 다음 ICMP 요청 유형을 선택합니다.
테스트를 실행할 환경의 Domain Name이나 IP 주소를 지정하세요.
Track number of network hops (TTL) 사용 여부를 선택하세요. 이 기능을 사용하면 “추적 경로” 프로브가 활성화되어 호스트 대상으로 가는 게이트웨이와 경로를 모두 찾을 수 있습니다.
Number of Pings를 테스트 세션별로 트리거되도록 선택하세요. Ping 개수의 기본 값은 네 개입니다. 이 수치를 줄이거나 최대 10개까지로 올릴 수 있습니다.
내 ICMP 테스트의 이름을 지정하세요.
ICMP 테스트에 환경 태그 및 기타 태그를 추가합니다. 이러한 태그를 사용하여 신서틱 모니터링 & 지속적인 테스트 페이지에서 신서틱 테스트를 필터링할 수 있습니다.
호스트 테스트를 클릭하여 요청 설정을 테스트합니다. 화면 오른쪽에 응답 미리보기가 표시됩니다.
8. 테스트 생성하기를 클릭하여 API 테스트를 제출합니다.
Snippets
When setting up a new Synthetic Monitoring API test, use snippets to automatically fill in basic auth, performance, and regions, rather than selecting these options manually. The following snippets are available:
Basic Auth: Automatically test your APIs using pre-populated basic auth headers, JavaScript, bearer token, and API/app key auth variables.
Performance: Automatically configure a test with the shortest frequency (one minute), perform a gRPC health check, and test for overall response time latency with a breakdown of network timing.
Regions: Automatically test your API endpoint against a location in each of the three primary geographic regions (AMER, APAC and EMEA).
어설션 정의
어설션은 예상되는 테스트 결과를 정의합니다. Test URL을 클릭하면 latency, packet loss, packet received의 기본 어설션과 사용 가능한 레코드가 추가됩니다. 테스트에서 모니터링을 시작하려면 어설션을 최소 한 개 정의해야 합니다.
유형
집계
연산자
값 유형
대기 시간
avg, max, min, 또는 stddev (jitter)
is less than, is less than or equal, is, is more than, is more than or equal
정수(ms)
패킷 손실
-
is less than, is less than or equal, is, is more than, is more than or equal
비율(%)
수신한 패킷
-
is less than, is less than or equal, is, is more than, is more than or equal
정수
네트워크 홉
-
is less than, is less than or equal, is, is more than, is more than or equal
정수
New Assertion을 선택하거나 응답 미리 보기를 바로 선택해 API 테스트별로 어설션을 최대 20개까지 만들 수 있습니다.
테스트에 응답 본문 어설션이 포함되어 있지 않으면 본문 페이로드가 삭제되고 Synthetics Worker가 설정한 제한 시간 내에서 요청 관련 응답 시간을 반환합니다.
테스트에 응답 본문에 대한 어서션이 포함되어 있고 제한 시간에 도달하면, Assertions on the body/response cannot be run beyond this limit 오류가 나타납니다.
위치 선택
ICMP 테스트를 실행할 Locations를 선택합니다. ICMP 테스트는 사용자가 트리거를 네트워크 외부 또는 내부에서 일으키고자 하느냐에 관리형 위치와 프라이빗 위치 모두에서 실행될 수 있습니다.
Datadog’s out-of-the-box managed locations allow you to test public-facing websites and endpoints from regions where your customers are located.
AWS:
Americas
Asia Pacific
EMEA
Canada Central
Hong Kong
Bahrain
Northern California
Jakarta
Cape Town
Northern Virginia
Mumbai
Frankfurt
Ohio
Osaka
Ireland
Oregon
Seoul
London
São Paulo
Singapore
Milan
Sydney
Paris
Tokyo
Stockholm
GCP:
Americas
Asia Pacific
EMEA
Dallas
Tokyo
Frankfurt
Los Angeles
Oregon
Virginia
Azure:
Region
Location
Americas
Virginia
The Datadog for Government site (US1-FED) uses the following managed location:
Region
Location
Americas
US-West
테스트 빈도 지정
ICMP 테스트를 다음과 같이 실행할 수 있습니다.
일정에 따라 실행하면 사용자가 가장 중요한 서비스에 항상 액세스할 수 있도록 보장합니다. Datadog에서 ICMP 테스트를 실행할 빈도를 선택하세요.
To create a local variable, click + All steps > Variables. You can select one of the following available builtins to add to your variable string:
{{ numeric(n) }}
Generates a numeric string with n digits.
{{ alphabetic(n) }}
Generates an alphabetic string with n letters.
{{ alphanumeric(n) }}
Generates an alphanumeric string with n characters.
{{ date(n unit, format) }}
Generates a date in one of Datadog’s accepted formats with a value corresponding to the UTC date the test is initiated at + or - n units.
{{ timestamp(n, unit) }}
Generates a timestamp in one of Datadog’s accepted units with a value corresponding to the UTC timestamp the test is initiated at +/- n units.
{{ uuid }}
Generates a version 4 universally unique identifier (UUID).
{{ public-id }}
Injects the Public ID of your test.
{{ result-id }}
Injects the Result ID of your test run.
To obfuscate local variable values in test results, select Hide and obfuscate variable value. Once you have defined the variable string, click Add Variable.
하나 이상의 어서션을 충족하지 않거나 요청이 초기에 실패한 경우 테스트는 FAILED로 간주됩니다. 경우에 따라서는 엔드포인트 어서션 테스트 없이 해당 테스트가 실패할 수 있습니다.
다음과 같은 이유로 실패할 수 있습니다.
DNS
테스트 URL의 DNS 항목을 찾을 수 없는 경우입니다. 가능한 원인으로는 테스트 URL이 잘못 설정되었거나 DNS 엔티티 설정이 잘못되었기 때문일 수 있습니다.
권한
기본적으로 [Datadog Admin 및 Datadog Standard 역할][13]이 있는 사용자만 Synthetic ICMP 테스트를 생성, 편집, 삭제할 수 있습니다. Synthetic ICMP 테스트의 생성, 편집, 삭제 액세스 권한을 얻으려면 사용자를 두 가지 [기본 역할][13] 중 하나로 업그레이드하세요.
커스텀 역할 기능을 사용하는 경우 synthetics_read 및 synthetics_write 권한이 포함된 사용자 정의 역할에 사용자를 추가하세요.
액세스 제한
Use granular access control to limit who has access to your test based on roles, teams, or individual users:
Open the permissions section of the form.
Click Edit Access.
Click Restrict Access.
Select teams, roles, or users.
Click Add.
Select the level of access you want to associate with each of them.
Click Done.
You can view results from a Private Location even without Viewer access to that Private Location.