UDP Plugin Configuration Guide
1. Overview
2. configuration option (CONFIG_XXX)
Key=Value, with one settings item per line. All supported settings items are listed below with their descriptions.| Setting | Required | Default value | Description |
|---|---|---|---|
host | yes | — | Target Host address, supports domain name or IPv4/IPv6 address |
port | no | 80 | Target service port |
content | no | — | Data content to be sent |
timeout | no | 12000 | Overall timeout (unit: milliseconds) |
response | no | — | Expected response content, used for result verification |
checkType | no | 0 | Response verification type: 0-no verification, 1-exact match (echo), 2-includes match, 3-length match |
resplen | no | 0 | Expected response data length (only valid when checkType=3) |
2.1 Detailed description of item settings
host
test.example.com) or IP address (such as 192.168.1.1).port
80 is used by default.content
HEX:, followed by a hexadecimal string (such as HEX:7BA41302001A).BASE64:, followed by the Base64 encoded string.timeout
checkType
0: No verification. No data is received and no content comparison is performed.1: Echo exact match. Completely compare the received data with the data sent this time (equal byte by byte). This mode does not read the response settings entries.2: Contains a match. The received data must contain the content specified in the response settings items (supports substring matching and is case-sensitive).3: length match. The received data length (number of bytes) must be equal to the value specified in the resplen settings item.response
checkType=2.HEX: and BASE64: prefix formats are also supported.resplen
checkType=3, represents the expected length of response data bytes.3. Result indicators and calculation methods
| Indicator field index | Indicator name | Description |
|---|---|---|
0 | Total time spent | The complete time from Synthetic to the end |
1 | DNS resolution takes time | Time spent on domain name resolution |
3 | Sending time | The time from the start of sending to the successful completion of sending |
4 | reception time | The time to wait and receive response data from the completion of sending |
3.1 Indicator calculation logic
Total time taken (0) = Dial-test end timestamp - Dial-test start timestamp
DNS Time consumption (1) = DNS resolution end time - DNS resolution start time
(Only generated when host is a domain name; when the IP is filled in directly, this indicator will not be set and the value is 0)
Sending time (3) = data sending completion time - sending start time
Reception time (4) = data reception completion time - reception start time4. Error code description
| Error code | trigger scene |
|---|---|
612007 | DNS resolution failed. Unable to resolve domain name to IP address |
699003 | Data sending failed. sendTo The actual number of bytes sent is not as expected |
699004 | Data reception failed. recvfrom returns Exception |
699005 | Response verification failed. The received data does not comply with the verification rules of checkType settings |
5. settings example
5.1 Basic UDP echo test
5.2 Specify the response content to include verification
5.3 Specify response length verification
5.4 Domain name Target
6. Precautions
1.
2.
HEX: or BASE64: prefix, you need to ensure that the subsequent data format is correct, otherwise the test may fail or there will be no data.3.
checkType is not 0, if the verification fails, (699005) Error code will be reported.4.
content does not contain settings or is an empty string, the Synthetic process will be terminated before the sending phase, and only DNS will be generated.