Retrieve diagnostics information about the DNS resolver service deployed to the Service Point v4 instance.
Request: GET http://<spv4_ip_address>:2021/v2/diagnosticsSuccessful response
200 OK
{
"status": "GOOD",
"id": "12345678-0b31-4d52-a1b5-099a9cbe9773",
"clusterId": "test_fsp_1-a8ka819ut-use2oudmd5pq",
"applicationId": "12345678-db02-4c9a-a7ab-593bb8bd604c",
"currentVersion": "3.5.4",
"statusTimestamp": 1661950287144,
"services": [
{
"id": "sp-controller-service",
"status": "GOOD",
"statusTimestamp": 1661950287009,
"serviceVersion": "DEPRECATED",
"resourceDetails": {
"customer-instance-connection": "GOOD"
},
"additionalDetails": {
"dns-resolving-responses": {
"rootNSQuery": "NOERROR",
"edgeCloudEndpoint": "NOERROR"
}
},
"resources": [
{
"id": "customerInstanceConnection",
"type": "customerInstanceConnection",
"status": "GOOD",
"info": [],
"errors": []
},
{
"id": "dnsResolvingResponses",
"type": "dnsResolvingResponses",
"status": "GOOD",
"info": [
{
"name": "rootNSQuery",
"value": "NOERROR"
},
{
"name": "edgeCloudEndpoint",
"value": "NOERROR"
}
],
"errors": []
}
]
},
{
"id": "parclo-logging",
"status": "GOOD",
"statusTimestamp": 1661950287124,
"serviceVersion": "1.0.0-build1656",
"resourceDetails": {
"kinesis-stream-status": "GOOD"
},
"additionalDetails": {
"custom-logging-endpoint": {
"url": "",
"header-names": [],
"sha256-fingerprint": ""
},
"stored-offline-queries-bytes": 0,
"kinesis-put_success": 0,
"logging-endpoint-dropped-count": 0,
"logging-endpoint-put-success-count": 0,
"incoming-dns-events-dropped-count": 0,
"logging-to-edge-cloud-console": true,
"kinesis-put_fail": 0,
"logging-to-custom-logging-endpoint": false,
"logging-endpoint-put-failed-count": 0
},
"resources": [
{
"id": "unlogged-queries",
"type": "unlogged-queries",
"status": "N/A",
"info": [
{
"name": "stored-offline-queries-bytes",
"value": 0
},
{
"name": "incoming-dns-events-dropped-count",
"value": 0
}
],
"errors": []
},
{
"id": "logging-endpoint",
"type": "logging-endpoint",
"status": "N/A",
"info": [
{
"name": "logging-endpoint-dropped-count",
"value": 0
},
{
"name": "logging-endpoint-put-success-count",
"value": 0
},
{
"name": "logging-endpoint-put-failed-count",
"value": 0
}
],
"errors": []
},
{
"id": "logging-endpoint-settings",
"type": "setting",
"status": "N/A",
"info": [
{
"name": "max-open-requests",
"value": 1024
},
{
"name": "max-connections",
"value": 16
}
],
"errors": []
},
{
"id": "kinesis-stream",
"type": "kinesis-stream",
"status": "GOOD",
"info": [
{
"name": "kinesis-put_success",
"value": 0
},
{
"name": "kinesis-put_fail",
"value": 0
}
],
"errors": []
},
{
"id": "firehose-settings",
"type": "setting",
"status": "N/A",
"info": [
{
"name": "max-open-requests",
"value": 2048
},
{
"name": "max-connections",
"value": 32
}
],
"errors": []
},
{
"id": "firehose-credentials",
"type": "firehose-credentials",
"status": "GOOD",
"info": [
{
"name": "firehose-credential-expiration",
"value": 1661951004000
}
],
"errors": []
},
{
"id": "local-persistence",
"type": "local-persistence",
"status": "GOOD",
"info": [
{
"name": "db-delete-unhealthy-count",
"value": 0
}
],
"errors": []
},
{
"id": "memory",
"type": "container",
"status": "N/A",
"info": [
{
"name": "allocated-mb",
"value": 1641
}
],
"errors": []
}
]
},
{
"id": "dns-gateway-service",
"status": "GOOD",
"statusTimestamp": 1661950287134,
"serviceVersion": "2.0.0-build3243",
"additionalDetails": {
"settingsDiagnostics": {
"id": "ebe07778380e1cd1b77c5fb3d2c25f37f9ab3ed1",
"lastSettingsPollingTimestamp": 1661950287130,
"lastSuccessfulSettingsUpdateTimestamp": 1661950287130,
"lastSettingsPollingStatus": "UNCHANGED",
"namespaceDetails": [
{
"id": "f73b86e9-ad83-4a68-89fe-4864eb1b7b33",
"name": "test-Azure-NS",
"forwarders": [
"10.10.10.9"
],
"matchListsDomainCount": 58,
"exceptionListsDomainCount": 0,
"matchesAllDomains": true,
"matchCidrCount": 0,
"exceptionCidrCount": 0,
"ttl": -1,
"staleCacheEntriesTTL": 3600,
"umbrellaConfiguration": null,
"ecsConfiguration": null,
"dohEnabled": false,
"retryRCodes": [
3
]
},
{
"id": "c64ad2f0-ea0c-466c-ac60-e37794fdb515",
"name": "MS-AZURE-INTERNAL",
"forwarders": [
"168.63.129.16"
],
"matchListsDomainCount": 4,
"exceptionListsDomainCount": 0,
"matchesAllDomains": false,
"matchCidrCount": 0,
"exceptionCidrCount": 0,
"ttl": 10,
"staleCacheEntriesTTL": 3600,
"umbrellaConfiguration": null,
"ecsConfiguration": null,
"dohEnabled": false,
"retryRCodes": [
3
]
},
{
"id": "ad73c5cf-27a8-11e8-9308-0ae4387b2600",
"name": "Default",
"forwarders": [
"8.8.8.8",
"8.8.4.4"
],
"matchListsDomainCount": 1,
"exceptionListsDomainCount": 0,
"matchesAllDomains": true,
"matchCidrCount": 3,
"exceptionCidrCount": 0,
"ttl": -1,
"staleCacheEntriesTTL": 3600,
"umbrellaConfiguration": null,
"ecsConfiguration": null,
"dohEnabled": false,
"retryRCodes": [
3
]
}
]
},
"policyDiagnostics": {
"id": "-2000278519",
"policyEventTimestamp": 1661950287130,
"lastUpdateTimestamp": 1661950287130,
"lastPolicyEventResult": "UNCHANGED",
"policyDetails": [
{
"policyName": "test-Monitor-All",
"policyId": "1654021252273-c0161143-ea7c-49e3-8f97-24384f6ad914",
"numberDomains": 0,
"numberExceptions": 0,
"policyAction": "monitor"
},
{
"policyName": "Block Internet Facing Queries",
"policyId": "1654525863398-a8f3a676-b1f9-4fb4-b49a-5b64dd6af5f7",
"numberDomains": 0,
"numberExceptions": 0,
"policyAction": "block"
},
{
"policyName": "test-Azure-Feeds",
"policyId": "1654524700188-de8bf889-b7d6-413a-af74-f9d008055bfe",
"numberDomains": 2712844,
"numberExceptions": 0,
"policyAction": "block"
}
]
},
"timeZone": "America/Toronto"
},
"resources": [
{
"id": "namespace-413e4360-c746-42ff-84ab-342f5ce4e86f",
"type": "namespace",
"status": "GOOD",
"info": [
{
"name": "responses",
"value": 1
},
{
"name": "servfail-responses",
"value": 0
},
{
"name": "queries",
"value": 1
},
{
"name": "frontend-nxdomain",
"value": 0
},
{
"name": "frontend-servfail",
"value": 1
},
{
"name": "frontend-noerror",
"value": 0
},
{
"name": "acl-drops",
"value": 0
},
{
"name": "rule-drop",
"value": 0
},
{
"name": "rule-nxdomain",
"value": 0
},
{
"name": "rule-refused",
"value": 0
},
{
"name": "rule-servfail",
"value": 0
},
{
"name": "rule-truncated",
"value": 0
},
{
"name": "self-answered",
"value": 0
},
{
"name": "downstream-timeouts",
"value": 0
},
{
"name": "downstream-send-errors",
"value": 0
},
{
"name": "trunc-failures",
"value": 0
},
{
"name": "no-policy",
"value": 1
},
{
"name": "latency0-1",
"value": 1
},
{
"name": "latency1-10",
"value": 0
},
{
"name": "latency10-50",
"value": 0
},
{
"name": "latency50-100",
"value": 0
},
{
"name": "latency100-1000",
"value": 0
},
{
"name": "latency-slow",
"value": 0
},
{
"name": "latency-avg100",
"value": 0
},
{
"name": "latency-avg1000",
"value": 0
},
{
"name": "latency-avg10000",
"value": 0
},
{
"name": "latency-avg1000000",
"value": 0
},
{
"name": "latency-tcp-avg100",
"value": 0
},
{
"name": "latency-tcp-avg1000",
"value": 0
},
{
"name": "latency-tcp-avg10000",
"value": 0
},
{
"name": "latency-tcp-avg1000000",
"value": 0
},
{
"name": "latency-dot-avg100",
"value": 0
},
{
"name": "latency-dot-avg1000",
"value": 0
},
{
"name": "latency-dot-avg10000",
"value": 0
},
{
"name": "latency-dot-avg1000000",
"value": 0
},
{
"name": "latency-doh-avg100",
"value": 0
},
{
"name": "latency-doh-avg1000",
"value": 0
},
{
"name": "latency-doh-avg10000",
"value": 0
},
{
"name": "latency-doh-avg1000000",
"value": 0
},
{
"name": "latency-doq-avg100",
"value": 0
},
{
"name": "latency-doq-avg1000",
"value": 0
},
{
"name": "latency-doq-avg10000",
"value": 0
},
{
"name": "latency-doq-avg1000000",
"value": 0
},
{
"name": "latency-doh3-avg100",
"value": 0
},
{
"name": "latency-doh3-avg1000",
"value": 0
},
{
"name": "latency-doh3-avg10000",
"value": 0
},
{
"name": "latency-doh3-avg1000000",
"value": 0
},
{
"name": "uptime",
"value": 21064
},
{
"name": "real-memory-usage",
"value": 23937024
},
{
"name": "udp-in-errors",
"value": 0
},
{
"name": "udp-noport-errors",
"value": 0
},
{
"name": "udp-recvbuf-errors",
"value": 0
},
{
"name": "udp-sndbuf-errors",
"value": 0
},
{
"name": "udp-in-csum-errors",
"value": 0
},
{
"name": "udp6-in-errors",
"value": 0
},
{
"name": "udp6-recvbuf-errors",
"value": 0
},
{
"name": "udp6-sndbuf-errors",
"value": 0
},
{
"name": "udp6-noport-errors",
"value": 0
},
{
"name": "udp6-in-csum-errors",
"value": 0
},
{
"name": "tcp-listen-overflows",
"value": 0
},
{
"name": "noncompliant-queries",
"value": 0
},
{
"name": "noncompliant-responses",
"value": 0
},
{
"name": "proxy-protocol-invalid",
"value": 0
},
{
"name": "rdqueries",
"value": 1
},
{
"name": "empty-queries",
"value": 0
},
{
"name": "cache-hits",
"value": 0
},
{
"name": "cache-misses",
"value": 0
},
{
"name": "cpu-iowait",
"value": 26697
},
{
"name": "cpu-steal",
"value": 0
},
{
"name": "cpu-sys-msec",
"value": 9891
},
{
"name": "cpu-user-msec",
"value": 9053
},
{
"name": "fd-usage",
"value": 1090
},
{
"name": "dyn-blocked",
"value": 0
},
{
"name": "dyn-block-nmg-size",
"value": 0
},
{
"name": "security-status",
"value": 0
},
{
"name": "doh-query-pipe-full",
"value": 0
},
{
"name": "doh-response-pipe-full",
"value": 0
},
{
"name": "doq-response-pipe-full",
"value": 0
},
{
"name": "doh3-response-pipe-full",
"value": 0
},
{
"name": "outgoing-doh-query-pipe-full",
"value": 0
},
{
"name": "tcp-query-pipe-full",
"value": 0
},
{
"name": "tcp-cross-protocol-query-pipe-full",
"value": 0
},
{
"name": "tcp-cross-protocol-response-pipe-full",
"value": 0
},
{
"name": "latency-sum",
"value": 0
},
{
"name": "latency-count",
"value": 1
}
],
"errors": []
},
{
"id": "namespace-413e4360-c746-42ff-84ab-342f5ce4e86f-forwarder-0",
"type": "forwarder",
"status": "GOOD",
"info": [
{
"name": "reuseds",
"value": 0
},
{
"name": "tcpDiedReadingResponse",
"value": 0
},
{
"name": "tcpDiedSendingQuery",
"value": 0
},
{
"name": "dropRate",
"value": 0
},
{
"name": "order",
"value": 1
},
{
"name": "tcpTooManyConcurrentConnections",
"value": 0
},
{
"name": "healthCheckFailuresTimeout",
"value": 21031
},
{
"name": "name",
"value": ""
},
{
"name": "qps",
"value": 0
},
{
"name": "responses",
"value": 0
},
{
"name": "tcpAvgQueriesPerConnection",
"value": 0
},
{
"name": "healthCheckFailuresMismatch",
"value": 0
},
{
"name": "pools",
"value": []
},
{
"name": "address",
"value": "10.8.1.100:53"
},
{
"name": "tcpGaveUp",
"value": 0
},
{
"name": "tcpLatency",
"value": 0
},
{
"name": "tcpReusedConnections",
"value": 0
},
{
"name": "id",
"value": 0
},
{
"name": "tcpReadTimeouts",
"value": 0
},
{
"name": "weight",
"value": 1
},
{
"name": "tcpWriteTimeouts",
"value": 0
},
{
"name": "latency",
"value": 0
},
{
"name": "nonCompliantResponses",
"value": 0
},
{
"name": "qpsLimit",
"value": 0
},
{
"name": "healthCheckFailures",
"value": 21031
},
{
"name": "queries",
"value": 0
},
{
"name": "tcpAvgConnectionDuration",
"value": 0
},
{
"name": "tcpNewConnections",
"value": 0
},
{
"name": "tlsResumptions",
"value": 0
},
{
"name": "healthCheckFailuresInvalid",
"value": 0
},
{
"name": "tcpMaxConcurrentConnections",
"value": 0
},
{
"name": "healthCheckFailuresParsing",
"value": 0
},
{
"name": "protocol",
"value": "Do53 UDP"
},
{
"name": "outstanding",
"value": 0
},
{
"name": "healthCheckFailuresNetwork",
"value": 0
},
{
"name": "state",
"value": "down"
},
{
"name": "tcpConnectTimeouts",
"value": 0
},
{
"name": "tcpCurrentConnections",
"value": 0
},
{
"name": "sendErrors",
"value": 0
}
],
"errors": []
},
{
"id": "memory",
"type": "container",
"status": "N/A",
"info": [
{
"name": "allocated-mb",
"value": "2005"
}
],
"errors": []
},
{
"id": "cache-settings",
"type": "setting",
"status": "N/A",
"info": [
{
"name": "identity-cache-capacity",
"value": 67276636
},
{
"name": "response-cache-capacity",
"value": 269106544
}
],
"errors": []
}
]
},
{
"id": "status-service",
"status": "GOOD",
"statusTimestamp": 1661950287144,
"serviceVersion": "2.0.0-build582",
"resources": [
{
"id": "memory",
"type": "container",
"status": "N/A",
"info": [
{
"name": "allocated-mb",
"value": 160
}
]
}
]
}
],
"additionalDetails": {
"hostManager": "SDP",
"currentLocalTime": "2022-08-31 12:51:27",
"proxyConfiguration": {
"configured": false,
"protocol": null,
"port": null,
"host": null,
"authenticationEnabled": null
}
},
"registration": {
"registered": true,
"timestamp": 1656012490546,
"siteId": "12345678-9870-98ef-85dc-34faaca80643",
"customerId": "12345678-abcd-12ab-7890-acb9a5a1eg2",
"customerHostname": "customer.edge.bluec.at"
}
}Diagnostic changes in DRS v4.0.0
DNS resolver service v4.0.0 introduces the following changes to the response of the
diagnostics endpoint:
- All containers now display a
memorysection withinresourcesthat displays the amount of memory allocated to the container. The memory dynamically changes based on the resources available on the service point. - Within the
sp-controller-service:serviceVersionhas been deprecated as of DRS v3.11.x.certificateshas been removed and is no longer applicable as of DRS v3.11.x
- Within
parclo-logging:- Under
resources, thelogging-endpoint-settings,firehose-settings, andlocal-persistencesections have been added, and thememorysection has been updated. These fields are now dynamic and change based on the resources available on the service point.
- Under
- Within
dns-gateway-service:- The
memoryandcache-settingshave been added withinresourcesand dynamically change based on the resources available on the service point.
- The
Namespace details
Under settingsDiagnostics, nameSpaceDetails, the parameter
matchListDomainCount returns the total count of domains in
the match lists attached to the namespace. However, "." represents all domains, but is
counted as a single domain in the context of the domain list count. As a result, the
parameter matchesAllDomains returns true or false in the following situations:
- When one domain list is provided and contains "." as a domain, then matchesAllDomains will be true, but matchListDomainCount is 1.
- If more than 1 domain list is provided, but any list contains "." as a domain, then the flag will be true and the "matchListDomainCount" reflects the count of domains across all domain lists (counting "." as one domain).
- If no domain list is provided, then matchesAllDomains is true, but matchListDomainCount is 0.
- If a domain list is provided with domains other than "." then matchesAllDomains is false, and matchListDomainCount reflects the count of domains in that list.
The exceptionsListDomainCount parameter is the total count of domains in the exception domain lists attached to the namespace.