Get DNS time series grouped by dimension

client.Radar.DNS.TimeseriesGroupsV2(ctx, dimension, query) (*DNSTimeseriesGroupsV2Response, error)

GET/radar/dns/timeseries_groups/{dimension}

Retrieves the distribution of DNS queries grouped by dimension 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

dimension DNSTimeseriesGroupsV2ParamsDimension

Specifies the attribute by which to group the results.

One of the following:

const DNSTimeseriesGroupsV2ParamsDimensionAs DNSTimeseriesGroupsV2ParamsDimension = "AS"

const DNSTimeseriesGroupsV2ParamsDimensionCacheHit DNSTimeseriesGroupsV2ParamsDimension = "CACHE_HIT"

const DNSTimeseriesGroupsV2ParamsDimensionDNSSEC DNSTimeseriesGroupsV2ParamsDimension = "DNSSEC"

const DNSTimeseriesGroupsV2ParamsDimensionDNSSECAware DNSTimeseriesGroupsV2ParamsDimension = "DNSSEC_AWARE"

const DNSTimeseriesGroupsV2ParamsDimensionDNSSECE2E DNSTimeseriesGroupsV2ParamsDimension = "DNSSEC_E2E"

const DNSTimeseriesGroupsV2ParamsDimensionIPVersion DNSTimeseriesGroupsV2ParamsDimension = "IP_VERSION"

const DNSTimeseriesGroupsV2ParamsDimensionLocation DNSTimeseriesGroupsV2ParamsDimension = "LOCATION"

const DNSTimeseriesGroupsV2ParamsDimensionMatchingAnswer DNSTimeseriesGroupsV2ParamsDimension = "MATCHING_ANSWER"

const DNSTimeseriesGroupsV2ParamsDimensionProtocol DNSTimeseriesGroupsV2ParamsDimension = "PROTOCOL"

const DNSTimeseriesGroupsV2ParamsDimensionQueryType DNSTimeseriesGroupsV2ParamsDimension = "QUERY_TYPE"

const DNSTimeseriesGroupsV2ParamsDimensionResponseCode DNSTimeseriesGroupsV2ParamsDimension = "RESPONSE_CODE"

const DNSTimeseriesGroupsV2ParamsDimensionResponseTTL DNSTimeseriesGroupsV2ParamsDimension = "RESPONSE_TTL"

const DNSTimeseriesGroupsV2ParamsDimensionTLD DNSTimeseriesGroupsV2ParamsDimension = "TLD"

query DNSTimeseriesGroupsV2Params

AggInterval param.Field[DNSTimeseriesGroupsV2ParamsAggInterval]optional

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

const DNSTimeseriesGroupsV2ParamsAggInterval15m DNSTimeseriesGroupsV2ParamsAggInterval = "15m"

const DNSTimeseriesGroupsV2ParamsAggInterval1h DNSTimeseriesGroupsV2ParamsAggInterval = "1h"

const DNSTimeseriesGroupsV2ParamsAggInterval1d DNSTimeseriesGroupsV2ParamsAggInterval = "1d"

const DNSTimeseriesGroupsV2ParamsAggInterval1w DNSTimeseriesGroupsV2ParamsAggInterval = "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[[]DNSTimeseriesGroupsV2ParamsDNSSEC]optional

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

const DNSTimeseriesGroupsV2ParamsDNSSECInvalid DNSTimeseriesGroupsV2ParamsDNSSEC = "INVALID"

const DNSTimeseriesGroupsV2ParamsDNSSECInsecure DNSTimeseriesGroupsV2ParamsDNSSEC = "INSECURE"

const DNSTimeseriesGroupsV2ParamsDNSSECSecure DNSTimeseriesGroupsV2ParamsDNSSEC = "SECURE"

const DNSTimeseriesGroupsV2ParamsDNSSECOther DNSTimeseriesGroupsV2ParamsDNSSEC = "OTHER"

DNSSECAware param.Field[[]DNSTimeseriesGroupsV2ParamsDNSSECAware]optional

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

const DNSTimeseriesGroupsV2ParamsDNSSECAwareSupported DNSTimeseriesGroupsV2ParamsDNSSECAware = "SUPPORTED"

const DNSTimeseriesGroupsV2ParamsDNSSECAwareNotSupported DNSTimeseriesGroupsV2ParamsDNSSECAware = "NOT_SUPPORTED"

DNSSECE2E param.Field[[]bool]optional

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

Format param.Field[DNSTimeseriesGroupsV2ParamsFormat]optional

Format in which results will be returned.

const DNSTimeseriesGroupsV2ParamsFormatJson DNSTimeseriesGroupsV2ParamsFormat = "JSON"

const DNSTimeseriesGroupsV2ParamsFormatCsv DNSTimeseriesGroupsV2ParamsFormat = "CSV"

IPVersion param.Field[[]DNSTimeseriesGroupsV2ParamsIPVersion]optional

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

const DNSTimeseriesGroupsV2ParamsIPVersionIPv4 DNSTimeseriesGroupsV2ParamsIPVersion = "IPv4"

const DNSTimeseriesGroupsV2ParamsIPVersionIPv6 DNSTimeseriesGroupsV2ParamsIPVersion = "IPv6"

LimitPerGroup param.Field[int64]optional

Limits the number of objects per group to the top items within the specified time range. When item count exceeds the limit, extra items appear grouped under an "other" category.

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).

Normalization param.Field[DNSTimeseriesGroupsV2ParamsNormalization]optional

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

const DNSTimeseriesGroupsV2ParamsNormalizationPercentage DNSTimeseriesGroupsV2ParamsNormalization = "PERCENTAGE"

const DNSTimeseriesGroupsV2ParamsNormalizationMin0Max DNSTimeseriesGroupsV2ParamsNormalization = "MIN0_MAX"

Protocol param.Field[[]DNSTimeseriesGroupsV2ParamsProtocol]optional

Filters results by DNS transport protocol.

const DNSTimeseriesGroupsV2ParamsProtocolUdp DNSTimeseriesGroupsV2ParamsProtocol = "UDP"

const DNSTimeseriesGroupsV2ParamsProtocolTCP DNSTimeseriesGroupsV2ParamsProtocol = "TCP"

const DNSTimeseriesGroupsV2ParamsProtocolHTTPS DNSTimeseriesGroupsV2ParamsProtocol = "HTTPS"

const DNSTimeseriesGroupsV2ParamsProtocolTLS DNSTimeseriesGroupsV2ParamsProtocol = "TLS"

QueryType param.Field[[]DNSTimeseriesGroupsV2ParamsQueryType]optional

Filters results by DNS query type.

const DNSTimeseriesGroupsV2ParamsQueryTypeA DNSTimeseriesGroupsV2ParamsQueryType = "A"

const DNSTimeseriesGroupsV2ParamsQueryTypeAAAA DNSTimeseriesGroupsV2ParamsQueryType = "AAAA"

const DNSTimeseriesGroupsV2ParamsQueryTypeA6 DNSTimeseriesGroupsV2ParamsQueryType = "A6"

const DNSTimeseriesGroupsV2ParamsQueryTypeAfsdb DNSTimeseriesGroupsV2ParamsQueryType = "AFSDB"

const DNSTimeseriesGroupsV2ParamsQueryTypeAny DNSTimeseriesGroupsV2ParamsQueryType = "ANY"

const DNSTimeseriesGroupsV2ParamsQueryTypeApl DNSTimeseriesGroupsV2ParamsQueryType = "APL"

const DNSTimeseriesGroupsV2ParamsQueryTypeAtma DNSTimeseriesGroupsV2ParamsQueryType = "ATMA"

const DNSTimeseriesGroupsV2ParamsQueryTypeAXFR DNSTimeseriesGroupsV2ParamsQueryType = "AXFR"

const DNSTimeseriesGroupsV2ParamsQueryTypeCAA DNSTimeseriesGroupsV2ParamsQueryType = "CAA"

const DNSTimeseriesGroupsV2ParamsQueryTypeCdnskey DNSTimeseriesGroupsV2ParamsQueryType = "CDNSKEY"

const DNSTimeseriesGroupsV2ParamsQueryTypeCds DNSTimeseriesGroupsV2ParamsQueryType = "CDS"

const DNSTimeseriesGroupsV2ParamsQueryTypeCERT DNSTimeseriesGroupsV2ParamsQueryType = "CERT"

const DNSTimeseriesGroupsV2ParamsQueryTypeCNAME DNSTimeseriesGroupsV2ParamsQueryType = "CNAME"

const DNSTimeseriesGroupsV2ParamsQueryTypeCsync DNSTimeseriesGroupsV2ParamsQueryType = "CSYNC"

const DNSTimeseriesGroupsV2ParamsQueryTypeDhcid DNSTimeseriesGroupsV2ParamsQueryType = "DHCID"

const DNSTimeseriesGroupsV2ParamsQueryTypeDlv DNSTimeseriesGroupsV2ParamsQueryType = "DLV"

const DNSTimeseriesGroupsV2ParamsQueryTypeDname DNSTimeseriesGroupsV2ParamsQueryType = "DNAME"

const DNSTimeseriesGroupsV2ParamsQueryTypeDNSKEY DNSTimeseriesGroupsV2ParamsQueryType = "DNSKEY"

const DNSTimeseriesGroupsV2ParamsQueryTypeDoa DNSTimeseriesGroupsV2ParamsQueryType = "DOA"

const DNSTimeseriesGroupsV2ParamsQueryTypeDS DNSTimeseriesGroupsV2ParamsQueryType = "DS"

const DNSTimeseriesGroupsV2ParamsQueryTypeEid DNSTimeseriesGroupsV2ParamsQueryType = "EID"

const DNSTimeseriesGroupsV2ParamsQueryTypeEui48 DNSTimeseriesGroupsV2ParamsQueryType = "EUI48"

const DNSTimeseriesGroupsV2ParamsQueryTypeEui64 DNSTimeseriesGroupsV2ParamsQueryType = "EUI64"

const DNSTimeseriesGroupsV2ParamsQueryTypeGpos DNSTimeseriesGroupsV2ParamsQueryType = "GPOS"

const DNSTimeseriesGroupsV2ParamsQueryTypeGid DNSTimeseriesGroupsV2ParamsQueryType = "GID"

const DNSTimeseriesGroupsV2ParamsQueryTypeHinfo DNSTimeseriesGroupsV2ParamsQueryType = "HINFO"

const DNSTimeseriesGroupsV2ParamsQueryTypeHip DNSTimeseriesGroupsV2ParamsQueryType = "HIP"

const DNSTimeseriesGroupsV2ParamsQueryTypeHTTPS DNSTimeseriesGroupsV2ParamsQueryType = "HTTPS"

const DNSTimeseriesGroupsV2ParamsQueryTypeIpseckey DNSTimeseriesGroupsV2ParamsQueryType = "IPSECKEY"

const DNSTimeseriesGroupsV2ParamsQueryTypeIsdn DNSTimeseriesGroupsV2ParamsQueryType = "ISDN"

const DNSTimeseriesGroupsV2ParamsQueryTypeIxfr DNSTimeseriesGroupsV2ParamsQueryType = "IXFR"

const DNSTimeseriesGroupsV2ParamsQueryTypeKey DNSTimeseriesGroupsV2ParamsQueryType = "KEY"

const DNSTimeseriesGroupsV2ParamsQueryTypeKx DNSTimeseriesGroupsV2ParamsQueryType = "KX"

const DNSTimeseriesGroupsV2ParamsQueryTypeL32 DNSTimeseriesGroupsV2ParamsQueryType = "L32"

const DNSTimeseriesGroupsV2ParamsQueryTypeL64 DNSTimeseriesGroupsV2ParamsQueryType = "L64"

const DNSTimeseriesGroupsV2ParamsQueryTypeLOC DNSTimeseriesGroupsV2ParamsQueryType = "LOC"

const DNSTimeseriesGroupsV2ParamsQueryTypeLp DNSTimeseriesGroupsV2ParamsQueryType = "LP"

const DNSTimeseriesGroupsV2ParamsQueryTypeMaila DNSTimeseriesGroupsV2ParamsQueryType = "MAILA"

const DNSTimeseriesGroupsV2ParamsQueryTypeMailb DNSTimeseriesGroupsV2ParamsQueryType = "MAILB"

const DNSTimeseriesGroupsV2ParamsQueryTypeMB DNSTimeseriesGroupsV2ParamsQueryType = "MB"

const DNSTimeseriesGroupsV2ParamsQueryTypeMd DNSTimeseriesGroupsV2ParamsQueryType = "MD"

const DNSTimeseriesGroupsV2ParamsQueryTypeMf DNSTimeseriesGroupsV2ParamsQueryType = "MF"

const DNSTimeseriesGroupsV2ParamsQueryTypeMg DNSTimeseriesGroupsV2ParamsQueryType = "MG"

const DNSTimeseriesGroupsV2ParamsQueryTypeMinfo DNSTimeseriesGroupsV2ParamsQueryType = "MINFO"

const DNSTimeseriesGroupsV2ParamsQueryTypeMr DNSTimeseriesGroupsV2ParamsQueryType = "MR"

const DNSTimeseriesGroupsV2ParamsQueryTypeMX DNSTimeseriesGroupsV2ParamsQueryType = "MX"

const DNSTimeseriesGroupsV2ParamsQueryTypeNAPTR DNSTimeseriesGroupsV2ParamsQueryType = "NAPTR"

const DNSTimeseriesGroupsV2ParamsQueryTypeNb DNSTimeseriesGroupsV2ParamsQueryType = "NB"

const DNSTimeseriesGroupsV2ParamsQueryTypeNbstat DNSTimeseriesGroupsV2ParamsQueryType = "NBSTAT"

const DNSTimeseriesGroupsV2ParamsQueryTypeNid DNSTimeseriesGroupsV2ParamsQueryType = "NID"

const DNSTimeseriesGroupsV2ParamsQueryTypeNimloc DNSTimeseriesGroupsV2ParamsQueryType = "NIMLOC"

const DNSTimeseriesGroupsV2ParamsQueryTypeNinfo DNSTimeseriesGroupsV2ParamsQueryType = "NINFO"

const DNSTimeseriesGroupsV2ParamsQueryTypeNS DNSTimeseriesGroupsV2ParamsQueryType = "NS"

const DNSTimeseriesGroupsV2ParamsQueryTypeNsap DNSTimeseriesGroupsV2ParamsQueryType = "NSAP"

const DNSTimeseriesGroupsV2ParamsQueryTypeNsec DNSTimeseriesGroupsV2ParamsQueryType = "NSEC"

const DNSTimeseriesGroupsV2ParamsQueryTypeNsec3 DNSTimeseriesGroupsV2ParamsQueryType = "NSEC3"

const DNSTimeseriesGroupsV2ParamsQueryTypeNsec3Param DNSTimeseriesGroupsV2ParamsQueryType = "NSEC3PARAM"

const DNSTimeseriesGroupsV2ParamsQueryTypeNull DNSTimeseriesGroupsV2ParamsQueryType = "NULL"

const DNSTimeseriesGroupsV2ParamsQueryTypeNxt DNSTimeseriesGroupsV2ParamsQueryType = "NXT"

const DNSTimeseriesGroupsV2ParamsQueryTypeOpenpgpkey DNSTimeseriesGroupsV2ParamsQueryType = "OPENPGPKEY"

const DNSTimeseriesGroupsV2ParamsQueryTypeOpt DNSTimeseriesGroupsV2ParamsQueryType = "OPT"

const DNSTimeseriesGroupsV2ParamsQueryTypePTR DNSTimeseriesGroupsV2ParamsQueryType = "PTR"

const DNSTimeseriesGroupsV2ParamsQueryTypePx DNSTimeseriesGroupsV2ParamsQueryType = "PX"

const DNSTimeseriesGroupsV2ParamsQueryTypeRkey DNSTimeseriesGroupsV2ParamsQueryType = "RKEY"

const DNSTimeseriesGroupsV2ParamsQueryTypeRp DNSTimeseriesGroupsV2ParamsQueryType = "RP"

const DNSTimeseriesGroupsV2ParamsQueryTypeRrsig DNSTimeseriesGroupsV2ParamsQueryType = "RRSIG"

const DNSTimeseriesGroupsV2ParamsQueryTypeRt DNSTimeseriesGroupsV2ParamsQueryType = "RT"

const DNSTimeseriesGroupsV2ParamsQueryTypeSig DNSTimeseriesGroupsV2ParamsQueryType = "SIG"

const DNSTimeseriesGroupsV2ParamsQueryTypeSink DNSTimeseriesGroupsV2ParamsQueryType = "SINK"

const DNSTimeseriesGroupsV2ParamsQueryTypeSMIMEA DNSTimeseriesGroupsV2ParamsQueryType = "SMIMEA"

const DNSTimeseriesGroupsV2ParamsQueryTypeSOA DNSTimeseriesGroupsV2ParamsQueryType = "SOA"

const DNSTimeseriesGroupsV2ParamsQueryTypeSPF DNSTimeseriesGroupsV2ParamsQueryType = "SPF"

const DNSTimeseriesGroupsV2ParamsQueryTypeSRV DNSTimeseriesGroupsV2ParamsQueryType = "SRV"

const DNSTimeseriesGroupsV2ParamsQueryTypeSSHFP DNSTimeseriesGroupsV2ParamsQueryType = "SSHFP"

const DNSTimeseriesGroupsV2ParamsQueryTypeSVCB DNSTimeseriesGroupsV2ParamsQueryType = "SVCB"

const DNSTimeseriesGroupsV2ParamsQueryTypeTa DNSTimeseriesGroupsV2ParamsQueryType = "TA"

const DNSTimeseriesGroupsV2ParamsQueryTypeTalink DNSTimeseriesGroupsV2ParamsQueryType = "TALINK"

const DNSTimeseriesGroupsV2ParamsQueryTypeTkey DNSTimeseriesGroupsV2ParamsQueryType = "TKEY"

const DNSTimeseriesGroupsV2ParamsQueryTypeTLSA DNSTimeseriesGroupsV2ParamsQueryType = "TLSA"

const DNSTimeseriesGroupsV2ParamsQueryTypeTSIG DNSTimeseriesGroupsV2ParamsQueryType = "TSIG"

const DNSTimeseriesGroupsV2ParamsQueryTypeTXT DNSTimeseriesGroupsV2ParamsQueryType = "TXT"

const DNSTimeseriesGroupsV2ParamsQueryTypeUinfo DNSTimeseriesGroupsV2ParamsQueryType = "UINFO"

const DNSTimeseriesGroupsV2ParamsQueryTypeUID DNSTimeseriesGroupsV2ParamsQueryType = "UID"

const DNSTimeseriesGroupsV2ParamsQueryTypeUnspec DNSTimeseriesGroupsV2ParamsQueryType = "UNSPEC"

const DNSTimeseriesGroupsV2ParamsQueryTypeURI DNSTimeseriesGroupsV2ParamsQueryType = "URI"

const DNSTimeseriesGroupsV2ParamsQueryTypeWks DNSTimeseriesGroupsV2ParamsQueryType = "WKS"

const DNSTimeseriesGroupsV2ParamsQueryTypeX25 DNSTimeseriesGroupsV2ParamsQueryType = "X25"

const DNSTimeseriesGroupsV2ParamsQueryTypeZonemd DNSTimeseriesGroupsV2ParamsQueryType = "ZONEMD"

ResponseCode param.Field[[]DNSTimeseriesGroupsV2ParamsResponseCode]optional

Filters results by DNS response code.

const DNSTimeseriesGroupsV2ParamsResponseCodeNoerror DNSTimeseriesGroupsV2ParamsResponseCode = "NOERROR"

const DNSTimeseriesGroupsV2ParamsResponseCodeFormerr DNSTimeseriesGroupsV2ParamsResponseCode = "FORMERR"

const DNSTimeseriesGroupsV2ParamsResponseCodeServfail DNSTimeseriesGroupsV2ParamsResponseCode = "SERVFAIL"

const DNSTimeseriesGroupsV2ParamsResponseCodeNxdomain DNSTimeseriesGroupsV2ParamsResponseCode = "NXDOMAIN"

const DNSTimeseriesGroupsV2ParamsResponseCodeNotimp DNSTimeseriesGroupsV2ParamsResponseCode = "NOTIMP"

const DNSTimeseriesGroupsV2ParamsResponseCodeRefused DNSTimeseriesGroupsV2ParamsResponseCode = "REFUSED"

const DNSTimeseriesGroupsV2ParamsResponseCodeYxdomain DNSTimeseriesGroupsV2ParamsResponseCode = "YXDOMAIN"

const DNSTimeseriesGroupsV2ParamsResponseCodeYxrrset DNSTimeseriesGroupsV2ParamsResponseCode = "YXRRSET"

const DNSTimeseriesGroupsV2ParamsResponseCodeNxrrset DNSTimeseriesGroupsV2ParamsResponseCode = "NXRRSET"

const DNSTimeseriesGroupsV2ParamsResponseCodeNotauth DNSTimeseriesGroupsV2ParamsResponseCode = "NOTAUTH"

const DNSTimeseriesGroupsV2ParamsResponseCodeNotzone DNSTimeseriesGroupsV2ParamsResponseCode = "NOTZONE"

const DNSTimeseriesGroupsV2ParamsResponseCodeBadsig DNSTimeseriesGroupsV2ParamsResponseCode = "BADSIG"

const DNSTimeseriesGroupsV2ParamsResponseCodeBadkey DNSTimeseriesGroupsV2ParamsResponseCode = "BADKEY"

const DNSTimeseriesGroupsV2ParamsResponseCodeBadtime DNSTimeseriesGroupsV2ParamsResponseCode = "BADTIME"

const DNSTimeseriesGroupsV2ParamsResponseCodeBadmode DNSTimeseriesGroupsV2ParamsResponseCode = "BADMODE"

const DNSTimeseriesGroupsV2ParamsResponseCodeBadname DNSTimeseriesGroupsV2ParamsResponseCode = "BADNAME"

const DNSTimeseriesGroupsV2ParamsResponseCodeBadalg DNSTimeseriesGroupsV2ParamsResponseCode = "BADALG"

const DNSTimeseriesGroupsV2ParamsResponseCodeBadtrunc DNSTimeseriesGroupsV2ParamsResponseCode = "BADTRUNC"

const DNSTimeseriesGroupsV2ParamsResponseCodeBadcookie DNSTimeseriesGroupsV2ParamsResponseCode = "BADCOOKIE"

ResponseTTL param.Field[[]DNSTimeseriesGroupsV2ParamsResponseTTL]optional

Filters results by DNS response TTL.

const DNSTimeseriesGroupsV2ParamsResponseTTLLte1M DNSTimeseriesGroupsV2ParamsResponseTTL = "LTE_1M"

const DNSTimeseriesGroupsV2ParamsResponseTTLGt1MLte5M DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_1M_LTE_5M"

const DNSTimeseriesGroupsV2ParamsResponseTTLGt5MLte15M DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_5M_LTE_15M"

const DNSTimeseriesGroupsV2ParamsResponseTTLGt15MLte1H DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_15M_LTE_1H"

const DNSTimeseriesGroupsV2ParamsResponseTTLGt1HLte1D DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_1H_LTE_1D"

const DNSTimeseriesGroupsV2ParamsResponseTTLGt1DLte1W DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_1D_LTE_1W"

const DNSTimeseriesGroupsV2ParamsResponseTTLGt1W DNSTimeseriesGroupsV2ParamsResponseTTL = "GT_1W"

TLD param.Field[[]string]optional

Filters results by top-level domain.

ReturnsExpand Collapse

type DNSTimeseriesGroupsV2Response struct{…}

Meta DNSTimeseriesGroupsV2ResponseMeta

Metadata for the results.

AggInterval DNSTimeseriesGroupsV2ResponseMetaAggInterval

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

One of the following:

const DNSTimeseriesGroupsV2ResponseMetaAggIntervalFifteenMinutes DNSTimeseriesGroupsV2ResponseMetaAggInterval = "FIFTEEN_MINUTES"

const DNSTimeseriesGroupsV2ResponseMetaAggIntervalOneHour DNSTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_HOUR"

const DNSTimeseriesGroupsV2ResponseMetaAggIntervalOneDay DNSTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_DAY"

const DNSTimeseriesGroupsV2ResponseMetaAggIntervalOneWeek DNSTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_WEEK"

const DNSTimeseriesGroupsV2ResponseMetaAggIntervalOneMonth DNSTimeseriesGroupsV2ResponseMetaAggInterval = "ONE_MONTH"

ConfidenceInfo DNSTimeseriesGroupsV2ResponseMetaConfidenceInfo

Annotations []DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotation

DataSource DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource

Data source for annotations.

One of the following:

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceAll DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "ALL"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceAIBots DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "AI_BOTS"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceAIGateway DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "AI_GATEWAY"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceBGP DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "BGP"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceBots DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "BOTS"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceConnectionAnomaly DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "CONNECTION_ANOMALY"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceCT DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "CT"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNS DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNSMagnitude DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_MAGNITUDE"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDNSAS112 DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DNS_AS112"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceDos DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "DOS"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceEmailRouting DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_ROUTING"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceEmailSecurity DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "EMAIL_SECURITY"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceFw DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "FW"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceFwPg DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "FW_PG"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTP DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPControl DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CONTROL"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPCrawlerReferer DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_CRAWLER_REFERER"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceHTTPOrigins DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "HTTP_ORIGINS"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceIQI DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "IQI"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceLeakedCredentials DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "LEAKED_CREDENTIALS"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceNet DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "NET"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceRobotsTXT DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "ROBOTS_TXT"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceSpeed DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "SPEED"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSourceWorkersAI DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsDataSource = "WORKERS_AI"

Description string

EndDate Time

formatdate-time

EventType DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType

Event type for annotations.

One of the following:

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeEvent DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "EVENT"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeGeneral DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "GENERAL"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeOutage DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "OUTAGE"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypePartialProjection DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "PARTIAL_PROJECTION"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypePipeline DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "PIPELINE"

const DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventTypeTrafficAnomaly DNSTimeseriesGroupsV2ResponseMetaConfidenceInfoAnnotationsEventType = "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 []DNSTimeseriesGroupsV2ResponseMetaDateRange

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 DNSTimeseriesGroupsV2ResponseMetaNormalization

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

One of the following:

const DNSTimeseriesGroupsV2ResponseMetaNormalizationPercentage DNSTimeseriesGroupsV2ResponseMetaNormalization = "PERCENTAGE"

const DNSTimeseriesGroupsV2ResponseMetaNormalizationMin0Max DNSTimeseriesGroupsV2ResponseMetaNormalization = "MIN0_MAX"

const DNSTimeseriesGroupsV2ResponseMetaNormalizationMinMax DNSTimeseriesGroupsV2ResponseMetaNormalization = "MIN_MAX"

const DNSTimeseriesGroupsV2ResponseMetaNormalizationRawValues DNSTimeseriesGroupsV2ResponseMetaNormalization = "RAW_VALUES"

const DNSTimeseriesGroupsV2ResponseMetaNormalizationPercentageChange DNSTimeseriesGroupsV2ResponseMetaNormalization = "PERCENTAGE_CHANGE"

const DNSTimeseriesGroupsV2ResponseMetaNormalizationRollingAverage DNSTimeseriesGroupsV2ResponseMetaNormalization = "ROLLING_AVERAGE"

const DNSTimeseriesGroupsV2ResponseMetaNormalizationOverlappedPercentage DNSTimeseriesGroupsV2ResponseMetaNormalization = "OVERLAPPED_PERCENTAGE"

const DNSTimeseriesGroupsV2ResponseMetaNormalizationRatio DNSTimeseriesGroupsV2ResponseMetaNormalization = "RATIO"

Units []DNSTimeseriesGroupsV2ResponseMetaUnit

Measurement units for the results.

Name string

Value string

Serie0 DNSTimeseriesGroupsV2ResponseSerie0

Timestamps []Time

Get DNS time series grouped by dimension

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.TimeseriesGroupsV2(
    context.TODO(),
    radar.DNSTimeseriesGroupsV2ParamsDimensionAs,
    radar.DNSTimeseriesGroupsV2Params{

    },
  )
  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"
        }
      ]
    },
    "serie_0": {
      "timestamps": [
        "2023-08-08T10:15:00Z"
      ]
    }
  },
  "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"
        }
      ]
    },
    "serie_0": {
      "timestamps": [
        "2023-08-08T10:15:00Z"
      ]
    }
  },
  "success": true
}