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": "1.0.0-build1013",
"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": "certificates",
"type": "certificates",
"status": "GOOD",
"info": [
{
"name": "clientCertificateExpiration",
"value": 1725729422000
},
{
"name": "caCertificateExpiration",
"value": 1725729422000
}
],
"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": "kinesis-stream",
"type": "kinesis-stream",
"status": "GOOD",
"info": [
{
"name": "kinesis-put_success",
"value": 0
},
{
"name": "kinesis-put_fail",
"value": 0
}
],
"errors": []
},
{
"id": "firehose-credentials",
"type": "firehose-credentials",
"status": "GOOD",
"info": [
{
"name": "firehose-credential-expiration",
"value": 1661951004000
}
],
"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-f73b86e9-ad83-4a68-89fe-4864eb1b7b33",
"type": "namespace",
"status": "GOOD",
"info": [
{
"name": "responses",
"value": 0
},
{
"name": "servfail-responses",
"value": 0
},
{
"name": "queries",
"value": 0
},
{
"name": "frontend-nxdomain",
"value": 0
},
{
"name": "frontend-servfail",
"value": 0
},
{
"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": 0
},
{
"name": "latency0-1",
"value": 0
},
{
"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": "uptime",
"value": 499128
},
{
"name": "real-memory-usage",
"value": 80310272
},
{
"name": "udp-in-errors",
"value": 0
},
{
"name": "udp-noport-errors",
"value": 22
},
{
"name": "udp-recvbuf-errors",
"value": 0
},
{
"name": "udp-sndbuf-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": 0
},
{
"name": "empty-queries",
"value": 0
},
{
"name": "cache-hits",
"value": 0
},
{
"name": "cache-misses",
"value": 0
},
{
"name": "cpu-iowait",
"value": 791111
},
{
"name": "cpu-steal",
"value": 0
},
{
"name": "cpu-sys-msec",
"value": 204291
},
{
"name": "cpu-user-msec",
"value": 882943
},
{
"name": "fd-usage",
"value": 46
},
{
"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": "latency-sum",
"value": 0
},
{
"name": "latency-count",
"value": 0
}
],
"errors": []
},
{
"id": "namespace-f73b86e9-ad83-4a68-89fe-4864eb1b7b33-forwarder-0",
"type": "forwarder",
"status": "GOOD",
"info": [
{
"name": "tcpConnectTimeouts",
"value": 0
},
{
"name": "tcpMaxConcurrentConnections",
"value": 0
},
{
"name": "tcpWriteTimeouts",
"value": 0
},
{
"name": "tcpAvgQueriesPerConnection",
"value": 0
},
{
"name": "sendErrors",
"value": 0
},
{
"name": "name",
"value": "8.8.8.8:53"
},
{
"name": "latency",
"value": 0
},
{
"name": "tcpReusedConnections",
"value": 0
},
{
"name": "dropRate",
"value": 0
},
{
"name": "id",
"value": 0
},
{
"name": "qps",
"value": 0
},
{
"name": "qpsLimit",
"value": 0
},
{
"name": "responses",
"value": 0
},
{
"name": "state",
"value": "up"
},
{
"name": "reuseds",
"value": 0
},
{
"name": "tcpDiedSendingQuery",
"value": 0
},
{
"name": "tcpAvgConnectionDuration",
"value": 0
},
{
"name": "weight",
"value": 1
},
{
"name": "pools",
"value": []
},
{
"name": "tcpNewConnections",
"value": 0
},
{
"name": "address",
"value": "8.8.8.8:53"
},
{
"name": "tcpCurrentConnections",
"value": 0
},
{
"name": "tcpGaveUp",
"value": 0
},
{
"name": "tcpReadTimeouts",
"value": 0
},
{
"name": "queries",
"value": 0
},
{
"name": "order",
"value": 1
},
{
"name": "outstanding",
"value": 0
},
{
"name": "tcpDiedReadingResponse",
"value": 0
}
],
"errors": []
},
{
"id": "namespace-f73b86e9-ad83-4a68-89fe-4864eb1b7b33-forwarder-1",
"type": "forwarder",
"status": "GOOD",
"info": [
{
"name": "id",
"value": 1
},
{
"name": "tcpAvgConnectionDuration",
"value": 0
},
{
"name": "state",
"value": "up"
},
{
"name": "tcpNewConnections",
"value": 0
},
{
"name": "pools",
"value": []
},
{
"name": "tcpReusedConnections",
"value": 0
},
{
"name": "latency",
"value": 0
},
{
"name": "dropRate",
"value": 0
},
{
"name": "qps",
"value": 0
},
{
"name": "qpsLimit",
"value": 0
},
{
"name": "outstanding",
"value": 0
},
{
"name": "tcpAvgQueriesPerConnection",
"value": 0
},
{
"name": "weight",
"value": 1
},
{
"name": "tcpDiedSendingQuery",
"value": 0
},
{
"name": "order",
"value": 1
},
{
"name": "address",
"value": "8.8.4.4:53"
},
{
"name": "responses",
"value": 0
},
{
"name": "sendErrors",
"value": 0
},
{
"name": "tcpDiedReadingResponse",
"value": 0
},
{
"name": "name",
"value": "8.8.4.4:53"
},
{
"name": "tcpCurrentConnections",
"value": 0
},
{
"name": "tcpGaveUp",
"value": 0
},
{
"name": "tcpMaxConcurrentConnections",
"value": 0
},
{
"name": "tcpConnectTimeouts",
"value": 0
},
{
"name": "tcpReadTimeouts",
"value": 0
},
{
"name": "queries",
"value": 0
},
{
"name": "tcpWriteTimeouts",
"value": 0
},
{
"name": "reuseds",
"value": 0
}
],
"errors": []
},
{
"id": "namespace-c64ad2f0-ea0c-466c-ac60-e37794fdb515",
"type": "namespace",
"status": "GOOD",
"info": [
{
"name": "responses",
"value": 0
},
{
"name": "servfail-responses",
"value": 0
},
{
"name": "queries",
"value": 0
},
{
"name": "frontend-nxdomain",
"value": 0
},
{
"name": "frontend-servfail",
"value": 0
},
{
"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": 0
},
{
"name": "latency0-1",
"value": 0
},
{
"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": "uptime",
"value": 499128
},
{
"name": "real-memory-usage",
"value": 32608256
},
{
"name": "udp-in-errors",
"value": 0
},
{
"name": "udp-noport-errors",
"value": 22
},
{
"name": "udp-recvbuf-errors",
"value": 0
},
{
"name": "udp-sndbuf-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": 0
},
{
"name": "empty-queries",
"value": 0
},
{
"name": "cache-hits",
"value": 0
},
{
"name": "cache-misses",
"value": 0
},
{
"name": "cpu-iowait",
"value": 791111
},
{
"name": "cpu-steal",
"value": 0
},
{
"name": "cpu-sys-msec",
"value": 166722
},
{
"name": "cpu-user-msec",
"value": 322186
},
{
"name": "fd-usage",
"value": 44
},
{
"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": "latency-sum",
"value": 0
},
{
"name": "latency-count",
"value": 0
}
],
"errors": []
},
{
"id": "namespace-c64ad2f0-ea0c-466c-ac60-e37794fdb515-forwarder-0",
"type": "forwarder",
"status": "GOOD",
"info": [
{
"name": "outstanding",
"value": 0
},
{
"name": "address",
"value": "168.63.129.16:53"
},
{
"name": "dropRate",
"value": 0
},
{
"name": "name",
"value": "168.63.129.16:53"
},
{
"name": "tcpCurrentConnections",
"value": 0
},
{
"name": "pools",
"value": []
},
{
"name": "tcpAvgConnectionDuration",
"value": 0
},
{
"name": "latency",
"value": 0
},
{
"name": "order",
"value": 1
},
{
"name": "qpsLimit",
"value": 0
},
{
"name": "id",
"value": 0
},
{
"name": "tcpAvgQueriesPerConnection",
"value": 0
},
{
"name": "tcpDiedSendingQuery",
"value": 0
},
{
"name": "tcpGaveUp",
"value": 0
},
{
"name": "tcpMaxConcurrentConnections",
"value": 0
},
{
"name": "tcpNewConnections",
"value": 0
},
{
"name": "tcpReadTimeouts",
"value": 0
},
{
"name": "tcpWriteTimeouts",
"value": 0
},
{
"name": "tcpDiedReadingResponse",
"value": 0
},
{
"name": "queries",
"value": 0
},
{
"name": "qps",
"value": 0
},
{
"name": "responses",
"value": 0
},
{
"name": "reuseds",
"value": 0
},
{
"name": "sendErrors",
"value": 0
},
{
"name": "state",
"value": "down"
},
{
"name": "tcpConnectTimeouts",
"value": 0
},
{
"name": "tcpReusedConnections",
"value": 0
},
{
"name": "weight",
"value": 1
}
],
"errors": []
},
{
"id": "namespace-ad73c5cf-27a8-11e8-9308-0ae4387b2600",
"type": "namespace",
"status": "GOOD",
"info": [
{
"name": "responses",
"value": 0
},
{
"name": "servfail-responses",
"value": 0
},
{
"name": "queries",
"value": 0
},
{
"name": "frontend-nxdomain",
"value": 0
},
{
"name": "frontend-servfail",
"value": 0
},
{
"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": 0
},
{
"name": "latency0-1",
"value": 0
},
{
"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": "uptime",
"value": 499128
},
{
"name": "real-memory-usage",
"value": 35340288
},
{
"name": "udp-in-errors",
"value": 0
},
{
"name": "udp-noport-errors",
"value": 22
},
{
"name": "udp-recvbuf-errors",
"value": 0
},
{
"name": "udp-sndbuf-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": 0
},
{
"name": "empty-queries",
"value": 0
},
{
"name": "cache-hits",
"value": 0
},
{
"name": "cache-misses",
"value": 0
},
{
"name": "cpu-iowait",
"value": 791111
},
{
"name": "cpu-steal",
"value": 0
},
{
"name": "cpu-sys-msec",
"value": 167017
},
{
"name": "cpu-user-msec",
"value": 324319
},
{
"name": "fd-usage",
"value": 46
},
{
"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": "latency-sum",
"value": 0
},
{
"name": "latency-count",
"value": 0
}
],
"errors": []
},
{
"id": "namespace-ad73c5cf-27a8-11e8-9308-0ae4387b2600-forwarder-0",
"type": "forwarder",
"status": "GOOD",
"info": [
{
"name": "tcpGaveUp",
"value": 0
},
{
"name": "name",
"value": "10.10.10.9:53"
},
{
"name": "pools",
"value": []
},
{
"name": "responses",
"value": 0
},
{
"name": "weight",
"value": 1
},
{
"name": "outstanding",
"value": 0
},
{
"name": "queries",
"value": 0
},
{
"name": "dropRate",
"value": 0
},
{
"name": "reuseds",
"value": 0
},
{
"name": "qpsLimit",
"value": 0
},
{
"name": "address",
"value": "10.10.10.9:53"
},
{
"name": "tcpAvgQueriesPerConnection",
"value": 0
},
{
"name": "tcpConnectTimeouts",
"value": 0
},
{
"name": "latency",
"value": 0
},
{
"name": "tcpCurrentConnections",
"value": 0
},
{
"name": "order",
"value": 1
},
{
"name": "tcpNewConnections",
"value": 0
},
{
"name": "state",
"value": "down"
},
{
"name": "tcpReusedConnections",
"value": 0
},
{
"name": "tcpWriteTimeouts",
"value": 0
},
{
"name": "tcpDiedReadingResponse",
"value": 0
},
{
"name": "tcpReadTimeouts",
"value": 0
},
{
"name": "sendErrors",
"value": 0
},
{
"name": "qps",
"value": 0
},
{
"name": "tcpAvgConnectionDuration",
"value": 0
},
{
"name": "id",
"value": 0
},
{
"name": "tcpDiedSendingQuery",
"value": 0
},
{
"name": "tcpMaxConcurrentConnections",
"value": 0
}
],
"errors": []
}
]
},
{
"id": "status-service",
"status": "GOOD",
"statusTimestamp": 1661950287144,
"serviceVersion": "2.0.0-build582"
}
],
"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"
}
}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.
Update information
In the updates section, the task field will display
UPGRADING regardless of whether the service point is upgrading to a newer DNS
resolver service software version or downgrading to an older software version.
Registration information
The field registrationFailureReason is only returned when the
registration status is FAILED. If the registration state can't be determined, the status
returned is N/A.