Fastly Stats

Fastly Stats
Certified
Fetch Fastly service statistics

Retrieves historical analytics for a single Fastly service or all services. When serviceId is provided the request targets /stats/service/{serviceId}; otherwise /stats is called (all services, optionally filtered by services).

The Fastly API returns up to 200 data points per call. For longer time windows, paginate by issuing successive calls with non-overlapping from/to values. hit_ratio in the response is a 0–1 float (e.g. 0.92 = 92 % cache hit rate).

yaml
type: io.kestra.plugin.fastly.stats.Stats

Examples

Fetch daily stats for a service over the past week

yaml
id: fastly_daily_stats
namespace: company.analytics

tasks:
  - id: fetch_stats
    type: io.kestra.plugin.fastly.stats.Stats
    apiToken: "{{ secret('FASTLY_API_TOKEN') }}"
    serviceId: "{{ secret('FASTLY_SERVICE_ID') }}"
    from: "7 days ago"
    to: "now"
    by: "day"

Fetch per-service window stats filtered by region

yaml
id: fastly_usa_stats
namespace: company.analytics

tasks:
  - id: fetch_usa_stats
    type: io.kestra.plugin.fastly.stats.Stats
    apiToken: "{{ secret('FASTLY_API_TOKEN') }}"
    serviceId: "{{ secret('FASTLY_SERVICE_ID') }}"
    from: "1 hour ago"
    to: "now"
    by: "minute"
    region: "usa"

Properties

apiToken *string

Fastly API token

Your Fastly API token. Create one in the Fastly console under Account > API tokens. Required scopes depend on the operation: URL and surrogate key purges require purge_select; purge-all requires purge_all; stats endpoints require global: read.

baseUrl string

Defaulthttps://api.fastly.com

Fastly API base URL

Base URL for the Fastly API. Override this only for testing.

by string

Aggregation granularity

Time bucket size for the returned data points. One of minute, hour, or day.

from string

Start of the time window

Beginning of the reporting window. Accepts Unix timestamps (seconds) or Fastly natural-language strings such as "1 hour ago" or "yesterday".

options

HTTP client options

Optional advanced HTTP settings such as timeouts or proxy configuration.

Definitions

io.kestra.core.http.client.configurations.HttpConfiguration

allowFailedbooleanstring

Defaultfalse

If true, allow a failed response code (response code >= 400)

allowedResponseCodesarray

SubTypeinteger

List of response code allowed for this request

auth

The authentication to use.

io.kestra.core.http.client.configurations.BasicAuthConfiguration

type*object

passwordstring

The password for HTTP basic authentication.

usernamestring

The username for HTTP basic authentication.

io.kestra.core.http.client.configurations.BearerAuthConfiguration

type*object

tokenstring

The token for bearer token authentication.

io.kestra.core.http.client.configurations.DigestAuthConfiguration

type*object

passwordstring

The password for HTTP Digest authentication.

usernamestring

The username for HTTP Digest authentication.

basicAuthPasswordstring

The password for HTTP basic authentication. Deprecated, use auth property with a BasicAuthConfiguration instance instead.

basicAuthUserstring

The username for HTTP basic authentication. Deprecated, use auth property with a BasicAuthConfiguration instance instead.

connectTimeoutstring

Formatduration

The time allowed to establish a connection to the server before failing.

connectionPoolIdleTimeoutstring

Formatduration

The time an idle connection can remain in the client's connection pool before being closed.

defaultCharsetstring

DefaultUTF-8

The default charset for the request.

java.nio.charset.Charset

enabledTcpExtendedKeepAlivebooleanstring

Defaulttrue

Whether to enable TCP Keep-Alive extended socket options (TCP_KEEPIDLE, TCP_KEEPINTERVAL, TCP_KEEPCOUNT).

Set to false when running on Windows workers, as these extended socket options are not supported by the Windows JDK and will cause connection failures.

followRedirectsbooleanstring

Defaulttrue

Whether redirects should be followed automatically.

logLevelstring

Possible Values

ALLTRACEDEBUGINFOWARNERROROFFNOT_SPECIFIED

The log level for the HTTP client.

logsarray

SubTypestring

Possible Values

REQUEST_HEADERSREQUEST_BODYRESPONSE_HEADERSRESPONSE_BODY

The enabled log.

maxContentLengthinteger

The maximum content length of the response.

proxy

The proxy configuration.

io.kestra.core.http.client.configurations.ProxyConfiguration

addressstring

The address of the proxy server.

passwordstring

The password for proxy authentication.

portintegerstring

The port of the proxy server.

typestring

DefaultDIRECT

Possible Values

DIRECTHTTPSOCKS

The type of proxy to use.

usernamestring

The username for proxy authentication.

proxyAddressstring

The address of the proxy server.

proxyPasswordstring

The password for proxy authentication.

proxyPortinteger

The port of the proxy server.

proxyTypestring

Possible Values

DIRECTHTTPSOCKS

The type of proxy to use.

proxyUsernamestring

The username for proxy authentication.

readIdleTimeoutstring

Formatduration

The time allowed for a read connection to remain idle before closing it.

readTimeoutstring

Formatduration

The maximum time allowed for reading data from the server before failing.

ssl

The SSL request options

io.kestra.core.http.client.configurations.SslOptions

insecureTrustAllCertificatesbooleanstring

Whether to disable checking of the remote SSL certificate.

Only applies if no trust store is configured. Note: This makes the SSL connection insecure and should only be used for testing. If you are using a self-signed certificate, set up a trust store instead.

timeout

The timeout configuration.

io.kestra.core.http.client.configurations.TimeoutConfiguration

connectTimeoutstring

The time allowed to establish a connection to the server before failing.

readIdleTimeoutstring

DefaultPT5M

The time allowed for a read connection to remain idle before closing it.

pluginDefaultsRef string

Reference (ref) of the pluginDefaults to apply to this task.

region string

Region filter

Restricts results to a specific POP region, e.g. usa, europe, asia. When omitted, global aggregate data is returned.

serviceId string

Service ID

When set, statistics are fetched for this specific service (/stats/service/{serviceId}). When omitted, statistics for all services are returned (/stats).

services string

Service filter (comma-separated IDs)

Comma-separated list of service IDs to include when fetching all-services stats. Only applicable when serviceId is not set. Ignored otherwise.

to string

End of the time window

End of the reporting window. Accepts Unix timestamps (seconds) or Fastly natural-language strings such as "now".

Outputs

data object

Stats data

Analytics data keyed by service id. Each value is the list of time-bucketed datapoint objects for that service. When serviceId is set, the single-service datapoint array is returned under that service's id so both single-service and all-services responses share the same uniform shape.

meta object

Response metadata

Metadata returned by Fastly, including pagination info and request parameters.

status string

Response status

Status field from the Fastly API envelope, typically ok.