Failure logging endpoint

Note

Not yet implemented

PUT /api/v1/servers/:server_id/failure

Configure query failure logging.

Query Parameters:
 
  • server_id – The name of the server

Example client body:

{
  "top-domains": 100,
  "domains": ".*\.example\.com$",
}
Property int top-domains:
 Number of top resolved domains that are automatically monitored for failures.
Property string domains:
 A Regex of domains that are additionally monitored for resolve failures.
GET /api/v1/servers/:server_id/failure

Note

Not yet implemented

Retrieve query failure logging and current config.

Example response body:

{
  "top-domains": 100,
  "domains": ".*\.example\.com$",
  "log": [
    {
      "first_occurred": 1234567890,
      "domain": "www.example.net",
      "qtype": "A",
      "failure": "dnssec-parent-validation-failed",
      "failed_parent": "example.com",
      "details": "foo bar",
      "queried_servers": [
         {
           "name": "ns1.example.net",
           "address": "192.0.2.53"
         },
      ]
    },
  ]
}
Property string failed_parent:
 

The parent domain, this is generally OPTIONAL.

Property string failure_code:
 

Reason of failure.

  • dnssec-validation-failed: DNSSEC Validation failed for this domain.
  • dnssec-parent-validation-failed: DNSSEC Validation failed for one of the parent domains. Response MUST contain failed_parent.
  • nxdomain: This domain was not present on the authoritative nameservers.
  • nodata: ???
  • all-servers-unreachable: All auth nameservers that have been tried did not respond.
  • parent-unresolvable: Response MUST contain failed_parent.
  • refused: All auth nameservers that have been tried responded with REFUSED.
  • servfail: All auth nameservers that have been tried responded with SERVFAIL.
Property string domain:
 

The domain queried