Axiom CloudWatch Forwarder

 

Axiom CloudWatch Forwarder is a set of easy-to-use AWS CloudFormation stacks designed to forward logs from Amazon CloudWatch to Axiom. It includes a Lambda function to handle the forwarding and stacks to create CloudWatch log group subscription filters for both existing and future log groups.

Documentation

For more information about how to set up and use the Axiom CloudWatch Forwarder, see the Axiom documentation.

Edge Ingestion

The forwarder supports edge-based regional ingestion for improved data locality. When configured, ingest operations are routed to regional edge endpoints while maintaining full backwards compatibility.

Configuration

Environment Variable	Description
AXIOM_EDGE_URL	Explicit edge URL (e.g., https://custom-edge.example.com). If a path is provided, the URL is used as-is. If no path is provided, /v1/ingest/{dataset} is appended. Takes precedence over AXIOM_EDGE.
AXIOM_EDGE	Regional edge domain (e.g., eu-central-1.aws.edge.axiom.co). When set, data is sent to https://{edge}/v1/ingest/{dataset}.

Priority: AXIOM_EDGE_URL > AXIOM_EDGE > AXIOM_URL (legacy)

Examples

# Traditional configuration (backwards compatible)
AXIOM_URL=https://api.axiom.co

# Regional edge ingestion
AXIOM_EDGE=eu-central-1.aws.edge.axiom.co

# Explicit edge URL
AXIOM_EDGE_URL=https://custom-edge.example.com

# Explicit edge URL with custom path (used as-is)
AXIOM_EDGE_URL=http://localhost:3400/ingest

CloudFormation Parameters

The forwarder stack accepts optional AxiomEdgeURL and AxiomEdge parameters for edge configuration. Existing deployments work unchanged—edge routing only activates when explicitly configured.