DNS Metrics

You can monitor the health, capacity, and performance of your DNS services by using metrics, alarms, and notifications.

This topic describes the metrics emitted by the metric namespace oci_dns (the DNS service).

Overview of DNS Service Metrics

The DNS service metrics help you measure the number of queries for DNS zones and DNS zones with traffic management policies attached.


  • IAM policies: To monitor resources, you must be given the required type of access in a policy  written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. The policy must give you access to the monitoring services as well as the resources being monitored. If you try to perform an action and get a message that you don’t have permission or are unauthorized, confirm with your administrator the type of access you've been granted and which compartment  you should work in. For more information on user authorizations for monitoring, see the Authentication and Authorization section for the related service: Monitoring or Notifications.

Available Metrics: oci_dns

The metrics listed in the following table are automatically available. You do not need to enable monitoring on the resource to get these metrics.

Each metric includes the following dimensions:

The OCID  of the zone to which the metric applies.
Metric Metric Display Name Unit Description Dimensions
DNSQueryCount DNSQueryCount count The number of queries for a DNS zone. resourceID
TrafficManagementQueryCount TrafficManagementQueryCount count The number of queries for a zone with Traffic Management policies attached. resourceID

Using the Console

DNS service metrics are available using the Metrics Explorer feature in the Console. For more information about metrics, see Viewing Metric Charts.

To view DNS metric charts
  1. Open the navigation menu and click Observability & Management. Under Monitoring, click Metrics Explorer.

    For Metric namespace, select oci_dns.

  2. Select a metric to view from the Metric name field.

  3. Select a qualifier specified in the Dimension Name field. For example, the dimension resourceId is specified in the metric definition for DNSQueryCount.
  4. Select the value you want to use for the specified dimension in the Dimension Value field. For example, the resource identifier for your instance of interest.

  5. Click Update Chart.

    The chart will be updated with the metrics that have been requested.

For more information about monitoring metrics and using alarms, see Monitoring. For information about notifications for alarms, see Notifications.