Get DNS queries time series

client.Radar.DNS.Timeseries(ctx, query) (*DNSTimeseriesResponse, error)

GET/radar/dns/timeseries

Retrieves normalized query volume to the 1.1.1.1 DNS resolver over time.

Security

API Token

The preferred authorization scheme for interacting with the Cloudflare API. Create a token.

Example:Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY

API Email + API Key

The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key.

Example:X-Auth-Email: user@example.com

The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys.

Example:X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194

Accepted Permissions (at least one required)

User Details WriteUser Details Read

ParametersExpand Collapse

query DNSTimeseriesParams

AggInterval param.Field[DNSTimeseriesParamsAggInterval]optional

Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

const DNSTimeseriesParamsAggInterval15m DNSTimeseriesParamsAggInterval = "15m"

const DNSTimeseriesParamsAggInterval1h DNSTimeseriesParamsAggInterval = "1h"

const DNSTimeseriesParamsAggInterval1d DNSTimeseriesParamsAggInterval = "1d"

const DNSTimeseriesParamsAggInterval1w DNSTimeseriesParamsAggInterval = "1w"

ASN param.Field[[]string]optional

Filters results by Autonomous System. Specify one or more Autonomous System Numbers (ASNs) as a comma-separated list. Prefix with - to exclude ASNs from results. For example, -174, 3356 excludes results from AS174, but includes results from AS3356.

CacheHit param.Field[[]bool]optional

Filters results based on cache status.

Continent param.Field[[]string]optional

Filters results by continent. Specify a comma-separated list of alpha-2 codes. Prefix with - to exclude continents from results. For example, -EU,NA excludes results from EU, but includes results from NA.

DateEnd param.Field[[]Time]optional

End of the date range (inclusive).

DateRange param.Field[[]string]optional

Filters results by date range. For example, use 7d and 7dcontrol to compare this week with the previous week. Use this parameter or set specific start and end dates (dateStart and dateEnd parameters).

DateStart param.Field[[]Time]optional

Start of the date range.

DNSSEC param.Field[[]DNSTimeseriesParamsDNSSEC]optional

Filters results based on DNSSEC (DNS Security Extensions) support.

const DNSTimeseriesParamsDNSSECInvalid DNSTimeseriesParamsDNSSEC = "INVALID"

const DNSTimeseriesParamsDNSSECInsecure DNSTimeseriesParamsDNSSEC = "INSECURE"

const DNSTimeseriesParamsDNSSECSecure DNSTimeseriesParamsDNSSEC = "SECURE"

const DNSTimeseriesParamsDNSSECOther DNSTimeseriesParamsDNSSEC = "OTHER"

DNSSECAware param.Field[[]DNSTimeseriesParamsDNSSECAware]optional

Filters results based on DNSSEC (DNS Security Extensions) client awareness.

const DNSTimeseriesParamsDNSSECAwareSupported DNSTimeseriesParamsDNSSECAware = "SUPPORTED"

const DNSTimeseriesParamsDNSSECAwareNotSupported DNSTimeseriesParamsDNSSECAware = "NOT_SUPPORTED"

DNSSECE2E param.Field[[]bool]optional

Filters results based on DNSSEC-validated answers by end-to-end security status.

Format param.Field[DNSTimeseriesParamsFormat]optional

Format in which results will be returned.

const DNSTimeseriesParamsFormatJson DNSTimeseriesParamsFormat = "JSON"

const DNSTimeseriesParamsFormatCsv DNSTimeseriesParamsFormat = "CSV"

IPVersion param.Field[[]DNSTimeseriesParamsIPVersion]optional

Filters results by IP version (Ipv4 vs. IPv6).

const DNSTimeseriesParamsIPVersionIPv4 DNSTimeseriesParamsIPVersion = "IPv4"

const DNSTimeseriesParamsIPVersionIPv6 DNSTimeseriesParamsIPVersion = "IPv6"

Location param.Field[[]string]optional

Filters results by location. Specify a comma-separated list of alpha-2 codes. Prefix with - to exclude locations from results. For example, -US,PT excludes results from the US, but includes results from PT.

MatchingAnswer param.Field[[]bool]optional

Filters results based on whether the queries have a matching answer.

Name param.Field[[]string]optional

Array of names used to label the series in the response.

Nodata param.Field[[]bool]optional

Specifies whether the response includes empty DNS responses (NODATA).

Protocol param.Field[[]DNSTimeseriesParamsProtocol]optional

Filters results by DNS transport protocol.

const DNSTimeseriesParamsProtocolUdp DNSTimeseriesParamsProtocol = "UDP"

const DNSTimeseriesParamsProtocolTCP DNSTimeseriesParamsProtocol = "TCP"

const DNSTimeseriesParamsProtocolHTTPS DNSTimeseriesParamsProtocol = "HTTPS"

const DNSTimeseriesParamsProtocolTLS DNSTimeseriesParamsProtocol = "TLS"

QueryType param.Field[[]DNSTimeseriesParamsQueryType]optional

Filters results by DNS query type.

const DNSTimeseriesParamsQueryTypeA DNSTimeseriesParamsQueryType = "A"

const DNSTimeseriesParamsQueryTypeAAAA DNSTimeseriesParamsQueryType = "AAAA"

const DNSTimeseriesParamsQueryTypeA6 DNSTimeseriesParamsQueryType = "A6"

const DNSTimeseriesParamsQueryTypeAfsdb DNSTimeseriesParamsQueryType = "AFSDB"

const DNSTimeseriesParamsQueryTypeAny DNSTimeseriesParamsQueryType = "ANY"

const DNSTimeseriesParamsQueryTypeApl DNSTimeseriesParamsQueryType = "APL"

const DNSTimeseriesParamsQueryTypeAtma DNSTimeseriesParamsQueryType = "ATMA"

const DNSTimeseriesParamsQueryTypeAXFR DNSTimeseriesParamsQueryType = "AXFR"

const DNSTimeseriesParamsQueryTypeCAA DNSTimeseriesParamsQueryType = "CAA"

const DNSTimeseriesParamsQueryTypeCdnskey DNSTimeseriesParamsQueryType = "CDNSKEY"

const DNSTimeseriesParamsQueryTypeCds DNSTimeseriesParamsQueryType = "CDS"

const DNSTimeseriesParamsQueryTypeCERT DNSTimeseriesParamsQueryType = "CERT"

const DNSTimeseriesParamsQueryTypeCNAME DNSTimeseriesParamsQueryType = "CNAME"

const DNSTimeseriesParamsQueryTypeCsync DNSTimeseriesParamsQueryType = "CSYNC"

const DNSTimeseriesParamsQueryTypeDhcid DNSTimeseriesParamsQueryType = "DHCID"

const DNSTimeseriesParamsQueryTypeDlv DNSTimeseriesParamsQueryType = "DLV"

const DNSTimeseriesParamsQueryTypeDname DNSTimeseriesParamsQueryType = "DNAME"

const DNSTimeseriesParamsQueryTypeDNSKEY DNSTimeseriesParamsQueryType = "DNSKEY"

const DNSTimeseriesParamsQueryTypeDoa DNSTimeseriesParamsQueryType = "DOA"

const DNSTimeseriesParamsQueryTypeDS DNSTimeseriesParamsQueryType = "DS"

const DNSTimeseriesParamsQueryTypeEid DNSTimeseriesParamsQueryType = "EID"

const DNSTimeseriesParamsQueryTypeEui48 DNSTimeseriesParamsQueryType = "EUI48"

const DNSTimeseriesParamsQueryTypeEui64 DNSTimeseriesParamsQueryType = "EUI64"

const DNSTimeseriesParamsQueryTypeGpos DNSTimeseriesParamsQueryType = "GPOS"

const DNSTimeseriesParamsQueryTypeGid DNSTimeseriesParamsQueryType = "GID"

const DNSTimeseriesParamsQueryTypeHinfo DNSTimeseriesParamsQueryType = "HINFO"

const DNSTimeseriesParamsQueryTypeHip DNSTimeseriesParamsQueryType = "HIP"

const DNSTimeseriesParamsQueryTypeHTTPS DNSTimeseriesParamsQueryType = "HTTPS"

const DNSTimeseriesParamsQueryTypeIpseckey DNSTimeseriesParamsQueryType = "IPSECKEY"

const DNSTimeseriesParamsQueryTypeIsdn DNSTimeseriesParamsQueryType = "ISDN"

const DNSTimeseriesParamsQueryTypeIxfr DNSTimeseriesParamsQueryType = "IXFR"

const DNSTimeseriesParamsQueryTypeKey DNSTimeseriesParamsQueryType = "KEY"

const DNSTimeseriesParamsQueryTypeKx DNSTimeseriesParamsQueryType = "KX"

const DNSTimeseriesParamsQueryTypeL32 DNSTimeseriesParamsQueryType = "L32"

const DNSTimeseriesParamsQueryTypeL64 DNSTimeseriesParamsQueryType = "L64"

const DNSTimeseriesParamsQueryTypeLOC DNSTimeseriesParamsQueryType = "LOC"

const DNSTimeseriesParamsQueryTypeLp DNSTimeseriesParamsQueryType = "LP"

const DNSTimeseriesParamsQueryTypeMaila DNSTimeseriesParamsQueryType = "MAILA"

const DNSTimeseriesParamsQueryTypeMailb DNSTimeseriesParamsQueryType = "MAILB"

const DNSTimeseriesParamsQueryTypeMB DNSTimeseriesParamsQueryType = "MB"

const DNSTimeseriesParamsQueryTypeMd DNSTimeseriesParamsQueryType = "MD"

const DNSTimeseriesParamsQueryTypeMf DNSTimeseriesParamsQueryType = "MF"

const DNSTimeseriesParamsQueryTypeMg DNSTimeseriesParamsQueryType = "MG"

const DNSTimeseriesParamsQueryTypeMinfo DNSTimeseriesParamsQueryType = "MINFO"

const DNSTimeseriesParamsQueryTypeMr DNSTimeseriesParamsQueryType = "MR"

const DNSTimeseriesParamsQueryTypeMX DNSTimeseriesParamsQueryType = "MX"

const DNSTimeseriesParamsQueryTypeNAPTR DNSTimeseriesParamsQueryType = "NAPTR"

const DNSTimeseriesParamsQueryTypeNb DNSTimeseriesParamsQueryType = "NB"

const DNSTimeseriesParamsQueryTypeNbstat DNSTimeseriesParamsQueryType = "NBSTAT"

const DNSTimeseriesParamsQueryTypeNid DNSTimeseriesParamsQueryType = "NID"

const DNSTimeseriesParamsQueryTypeNimloc DNSTimeseriesParamsQueryType = "NIMLOC"

const DNSTimeseriesParamsQueryTypeNinfo DNSTimeseriesParamsQueryType = "NINFO"

const DNSTimeseriesParamsQueryTypeNS DNSTimeseriesParamsQueryType = "NS"

const DNSTimeseriesParamsQueryTypeNsap DNSTimeseriesParamsQueryType = "NSAP"

const DNSTimeseriesParamsQueryTypeNsec DNSTimeseriesParamsQueryType = "NSEC"

const DNSTimeseriesParamsQueryTypeNsec3 DNSTimeseriesParamsQueryType = "NSEC3"

const DNSTimeseriesParamsQueryTypeNsec3Param DNSTimeseriesParamsQueryType = "NSEC3PARAM"

const DNSTimeseriesParamsQueryTypeNull DNSTimeseriesParamsQueryType = "NULL"

const DNSTimeseriesParamsQueryTypeNxt DNSTimeseriesParamsQueryType = "NXT"

const DNSTimeseriesParamsQueryTypeOpenpgpkey DNSTimeseriesParamsQueryType = "OPENPGPKEY"

const DNSTimeseriesParamsQueryTypeOpt DNSTimeseriesParamsQueryType = "OPT"

const DNSTimeseriesParamsQueryTypePTR DNSTimeseriesParamsQueryType = "PTR"

const DNSTimeseriesParamsQueryTypePx DNSTimeseriesParamsQueryType = "PX"

const DNSTimeseriesParamsQueryTypeRkey DNSTimeseriesParamsQueryType = "RKEY"

const DNSTimeseriesParamsQueryTypeRp DNSTimeseriesParamsQueryType = "RP"

const DNSTimeseriesParamsQueryTypeRrsig DNSTimeseriesParamsQueryType = "RRSIG"

const DNSTimeseriesParamsQueryTypeRt DNSTimeseriesParamsQueryType = "RT"

const DNSTimeseriesParamsQueryTypeSig DNSTimeseriesParamsQueryType = "SIG"

const DNSTimeseriesParamsQueryTypeSink DNSTimeseriesParamsQueryType = "SINK"

const DNSTimeseriesParamsQueryTypeSMIMEA DNSTimeseriesParamsQueryType = "SMIMEA"

const DNSTimeseriesParamsQueryTypeSOA DNSTimeseriesParamsQueryType = "SOA"

const DNSTimeseriesParamsQueryTypeSPF DNSTimeseriesParamsQueryType = "SPF"

const DNSTimeseriesParamsQueryTypeSRV DNSTimeseriesParamsQueryType = "SRV"

const DNSTimeseriesParamsQueryTypeSSHFP DNSTimeseriesParamsQueryType = "SSHFP"

const DNSTimeseriesParamsQueryTypeSVCB DNSTimeseriesParamsQueryType = "SVCB"

const DNSTimeseriesParamsQueryTypeTa DNSTimeseriesParamsQueryType = "TA"

const DNSTimeseriesParamsQueryTypeTalink DNSTimeseriesParamsQueryType = "TALINK"

const DNSTimeseriesParamsQueryTypeTkey DNSTimeseriesParamsQueryType = "TKEY"

const DNSTimeseriesParamsQueryTypeTLSA DNSTimeseriesParamsQueryType = "TLSA"

const DNSTimeseriesParamsQueryTypeTSIG DNSTimeseriesParamsQueryType = "TSIG"

const DNSTimeseriesParamsQueryTypeTXT DNSTimeseriesParamsQueryType = "TXT"

const DNSTimeseriesParamsQueryTypeUinfo DNSTimeseriesParamsQueryType = "UINFO"

const DNSTimeseriesParamsQueryTypeUID DNSTimeseriesParamsQueryType = "UID"

const DNSTimeseriesParamsQueryTypeUnspec DNSTimeseriesParamsQueryType = "UNSPEC"

const DNSTimeseriesParamsQueryTypeURI DNSTimeseriesParamsQueryType = "URI"

const DNSTimeseriesParamsQueryTypeWks DNSTimeseriesParamsQueryType = "WKS"

const DNSTimeseriesParamsQueryTypeX25 DNSTimeseriesParamsQueryType = "X25"

const DNSTimeseriesParamsQueryTypeZonemd DNSTimeseriesParamsQueryType = "ZONEMD"

ResponseCode param.Field[[]DNSTimeseriesParamsResponseCode]optional

Filters results by DNS response code.

const DNSTimeseriesParamsResponseCodeNoerror DNSTimeseriesParamsResponseCode = "NOERROR"

const DNSTimeseriesParamsResponseCodeFormerr DNSTimeseriesParamsResponseCode = "FORMERR"

const DNSTimeseriesParamsResponseCodeServfail DNSTimeseriesParamsResponseCode = "SERVFAIL"

const DNSTimeseriesParamsResponseCodeNxdomain DNSTimeseriesParamsResponseCode = "NXDOMAIN"

const DNSTimeseriesParamsResponseCodeNotimp DNSTimeseriesParamsResponseCode = "NOTIMP"

const DNSTimeseriesParamsResponseCodeRefused DNSTimeseriesParamsResponseCode = "REFUSED"

const DNSTimeseriesParamsResponseCodeYxdomain DNSTimeseriesParamsResponseCode = "YXDOMAIN"

const DNSTimeseriesParamsResponseCodeYxrrset DNSTimeseriesParamsResponseCode = "YXRRSET"

const DNSTimeseriesParamsResponseCodeNxrrset DNSTimeseriesParamsResponseCode = "NXRRSET"

const DNSTimeseriesParamsResponseCodeNotauth DNSTimeseriesParamsResponseCode = "NOTAUTH"

const DNSTimeseriesParamsResponseCodeNotzone DNSTimeseriesParamsResponseCode = "NOTZONE"

const DNSTimeseriesParamsResponseCodeBadsig DNSTimeseriesParamsResponseCode = "BADSIG"

const DNSTimeseriesParamsResponseCodeBadkey DNSTimeseriesParamsResponseCode = "BADKEY"

const DNSTimeseriesParamsResponseCodeBadtime DNSTimeseriesParamsResponseCode = "BADTIME"

const DNSTimeseriesParamsResponseCodeBadmode DNSTimeseriesParamsResponseCode = "BADMODE"

const DNSTimeseriesParamsResponseCodeBadname DNSTimeseriesParamsResponseCode = "BADNAME"

const DNSTimeseriesParamsResponseCodeBadalg DNSTimeseriesParamsResponseCode = "BADALG"

const DNSTimeseriesParamsResponseCodeBadtrunc DNSTimeseriesParamsResponseCode = "BADTRUNC"

const DNSTimeseriesParamsResponseCodeBadcookie DNSTimeseriesParamsResponseCode = "BADCOOKIE"

ResponseTTL param.Field[[]DNSTimeseriesParamsResponseTTL]optional

Filters results by DNS response TTL.

const DNSTimeseriesParamsResponseTTLLte1M DNSTimeseriesParamsResponseTTL = "LTE_1M"

const DNSTimeseriesParamsResponseTTLGt1MLte5M DNSTimeseriesParamsResponseTTL = "GT_1M_LTE_5M"

const DNSTimeseriesParamsResponseTTLGt5MLte15M DNSTimeseriesParamsResponseTTL = "GT_5M_LTE_15M"

const DNSTimeseriesParamsResponseTTLGt15MLte1H DNSTimeseriesParamsResponseTTL = "GT_15M_LTE_1H"

const DNSTimeseriesParamsResponseTTLGt1HLte1D DNSTimeseriesParamsResponseTTL = "GT_1H_LTE_1D"

const DNSTimeseriesParamsResponseTTLGt1DLte1W DNSTimeseriesParamsResponseTTL = "GT_1D_LTE_1W"

const DNSTimeseriesParamsResponseTTLGt1W DNSTimeseriesParamsResponseTTL = "GT_1W"

TLD param.Field[[]string]optional

Filters results by top-level domain.

ReturnsExpand Collapse

type DNSTimeseriesResponse struct{…}

Meta DNSTimeseriesResponseMeta

Metadata for the results.

AggInterval DNSTimeseriesResponseMetaAggInterval

Aggregation interval of the results (e.g., in 15 minutes or 1 hour intervals). Refer to Aggregation intervals.

One of the following:

const DNSTimeseriesResponseMetaAggIntervalFifteenMinutes DNSTimeseriesResponseMetaAggInterval = "FIFTEEN_MINUTES"

const DNSTimeseriesResponseMetaAggIntervalOneHour DNSTimeseriesResponseMetaAggInterval = "ONE_HOUR"

const DNSTimeseriesResponseMetaAggIntervalOneDay DNSTimeseriesResponseMetaAggInterval = "ONE_DAY"

const DNSTimeseriesResponseMetaAggIntervalOneWeek DNSTimeseriesResponseMetaAggInterval = "ONE_WEEK"

const DNSTimeseriesResponseMetaAggIntervalOneMonth DNSTimeseriesResponseMetaAggInterval = "ONE_MONTH"

ConfidenceInfo DNSTimeseriesResponseMetaConfidenceInfo

Annotations []DNSTimeseriesResponseMetaConfidenceInfoAnnotation

DataSource DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource

Data source for annotations.

One of the following:

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "CT"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "FW"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "NET"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"

Description string

EndDate Time

formatdate-time

EventType DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType

Event type for annotations.

One of the following:

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"

const DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesResponseMetaConfidenceInfoAnnotationsEventType = "TRAFFIC_ANOMALY"

IsInstantaneous bool

Whether event is a single point in time or a time range.

LinkedURL string

formaturi

StartDate Time

formatdate-time

Level int64

Provides an indication of how much confidence Cloudflare has in the data.

DateRange []DNSTimeseriesResponseMetaDateRange

EndTime Time

Adjusted end of date range.

formatdate-time

StartTime Time

Adjusted start of date range.

formatdate-time

LastUpdated Time

Timestamp of the last dataset update.

formatdate-time

Normalization DNSTimeseriesResponseMetaNormalization

Normalization method applied to the results. Refer to Normalization methods.

One of the following:

const DNSTimeseriesResponseMetaNormalizationPercentage DNSTimeseriesResponseMetaNormalization = "PERCENTAGE"

const DNSTimeseriesResponseMetaNormalizationMin0Max DNSTimeseriesResponseMetaNormalization = "MIN0_MAX"

const DNSTimeseriesResponseMetaNormalizationMinMax DNSTimeseriesResponseMetaNormalization = "MIN_MAX"

const DNSTimeseriesResponseMetaNormalizationRawValues DNSTimeseriesResponseMetaNormalization = "RAW_VALUES"

const DNSTimeseriesResponseMetaNormalizationPercentageChange DNSTimeseriesResponseMetaNormalization = "PERCENTAGE_CHANGE"

const DNSTimeseriesResponseMetaNormalizationRollingAverage DNSTimeseriesResponseMetaNormalization = "ROLLING_AVERAGE"

const DNSTimeseriesResponseMetaNormalizationOverlappedPercentage DNSTimeseriesResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"

const DNSTimeseriesResponseMetaNormalizationRatio DNSTimeseriesResponseMetaNormalization = "RATIO"

Units []DNSTimeseriesResponseMetaUnit

Measurement units for the results.

Name string

Value string

Get DNS queries time series

package main

import (
  "context"
  "fmt"

  "github.com/cloudflare/cloudflare-go"
  "github.com/cloudflare/cloudflare-go/option"
  "github.com/cloudflare/cloudflare-go/radar"
)

func main() {
  client := cloudflare.NewClient(
    option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"),
  )
  response, err := client.Radar.DNS.Timeseries(context.TODO(), radar.DNSTimeseriesParams{

  })
  if err != nil {
    panic(err.Error())
  }
  fmt.Printf("%+v\n", response.Meta)
}

{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "level": 0
      },
      "dateRange": [
        {
          "endTime": "2022-09-17T10:22:57.555Z",
          "startTime": "2022-09-16T10:22:57.555Z"
        }
      ],
      "lastUpdated": "2019-12-27T18:11:19.117Z",
      "normalization": "PERCENTAGE",
      "units": [
        {
          "name": "*",
          "value": "requests"
        }
      ]
    }
  },
  "success": true
}

Returns Examples

{
  "result": {
    "meta": {
      "aggInterval": "FIFTEEN_MINUTES",
      "confidenceInfo": {
        "annotations": [
          {
            "dataSource": "ALL",
            "description": "Cable cut in Tonga",
            "endDate": "2019-12-27T18:11:19.117Z",
            "eventType": "EVENT",
            "isInstantaneous": true,
            "linkedUrl": "https://example.com",
            "startDate": "2019-12-27T18:11:19.117Z"
          }
        ],
        "level": 0
      },
      "dateRange": [
        {
          "endTime": "2022-09-17T10:22:57.555Z",
          "startTime": "2022-09-16T10:22:57.555Z"
        }
      ],
      "lastUpdated": "2019-12-27T18:11:19.117Z",
      "normalization": "PERCENTAGE",
      "units": [
        {
          "name": "*",
          "value": "requests"
        }
      ]
    }
  },
  "success": true
}