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. When omitted, the interval is auto-selected from the requested date range; finer intervals are only available for shorter ranges. If the requested interval is too granular for the date range, the request is rejected.

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). Alternative to dateRange; provide together with dateStart. When requesting comparison series, every series must resolve to the same duration as the main series. Each dateStart/dateEnd is floored to the nearest 15 minutes before evaluation, so windows whose durations match only before alignment may be rejected.

DateRange param.Field[[]string]Optional

Filters results by relative date range ending at the current time, with each value producing a separate series. Use <n>d for days (up to 364d) or <n>w for weeks (up to 52w). Append control to request the equivalent previous period for comparison: the comparison window is shifted back by the current window’s length rounded up to a whole number of weeks, so it keeps the same weekday alignment and does not overlap the current window (e.g. 7dcontrol covers days -14 to -7, 10dcontrol covers days -24 to -14). For example, pass 7d and 7dcontrol to compare this week with the previous week. All series must resolve to the same duration as the main series; relative ranges (including control) satisfy this automatically. Use this parameter or set specific start and end dates (dateStart and dateEnd parameters).

DateStart param.Field[[]Time]Optional

Start of the date range. Alternative to dateRange; provide together with dateEnd. When requesting comparison series, every series must resolve to the same duration as the main series. Each dateStart/dateEnd is floored to the nearest 15 minutes before evaluation, so windows whose durations match only before alignment may be rejected.

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. Incompatible with the ipVersion, protocol, dnssecE2e, dnssecAware, responseTtl, and cacheHit filters/dimensions; this restriction does not apply to country-code TLDs (2-letter, e.g. uk).

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

Tags []stringOptional

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",
            "tags": [
              "BOT_CLASS"
            ]
          }
        ],
        "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",
            "tags": [
              "BOT_CLASS"
            ]
          }
        ],
        "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
}