Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. metrics
  4. Ingesting data
    1. Better Stack collector
    2. OpenTelemetry
    3. Vector
    4. Ingesting via HTTP API
    5. Ingesting metrics
    6. Ingesting logs
    7. Migrating to Better Stack
  5. Using the product
    1. AI SRE ↗
    2. MCP server ↗
    3. Transforming ingested data
    4. Querying data
    5. Tracing
    6. Grafana
    7. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources & collectors
      1. Sources API
        1. List all sources GET
        2. Get a single source GET
        3. Create a source POST
        4. Update a source PATCH
        5. Remove a source DELETE
        6. Connect to AWS PATCH
        7. Connect to GCP PATCH
      2. Collectors API
      3. Collector metrics targets API
      4. Metrics API
      5. Source groups API
    3. Dashboards
    4. Explorations
    5. Alerts API
    6. Connections API
    7. Query API ↗
    8. Usage API ↗
  7. Alternative to
    1. Lightstep

AWS log group subscriptions

Control which Amazon CloudWatch log groups Better Stack ingests for an aws source. These endpoints manage per-log-group subscription overrides. To subscribe every newly discovered log group automatically, set aws_auto_sub_log_groups when you update the source.

An override records the desired state for one log group, identified by its region and name. Set subscribed to true to ingest the log group or false to skip it. An override takes precedence over the source's auto-subscribe setting, and you can create one before the log group is discovered. Delete the override to return the log group to automatic behavior.

List log group subscriptions

Returns the log group subscription overrides for an aws source.

GET https://telemetry.betterstack.com/api/v2/sources/{source_id}/aws-log-group-subscriptions

URL parameters

source_id
required string

ID of the aws source

Query parameters

page
integer

Page number

per_page
integer

The number of subscriptions per page (max 50)

Headers

Authorization
required string

Bearer $TOKEN

200

Response body

{
  "data": [
    {
      "id": "1",
      "type": "aws_log_group_subscription",
      "attributes": {
        "region": "us-east-1",
        "name": "/aws/lambda/checkout",
        "subscribed": true,
        "created_at": "2026-08-19T12:30:41.695Z",
        "updated_at": "2026-08-19T12:30:41.695Z"
      }
    }
  ],
  "pagination": {
    "first": "https://telemetry.betterstack.com/api/v2/sources/95/aws-log-group-subscriptions?page=1&per_page=10",
    "last": "https://telemetry.betterstack.com/api/v2/sources/95/aws-log-group-subscriptions?page=1&per_page=10",
    "prev": null,
    "next": null
  }
}

Example cURL

List log group subscriptions
curl --request GET \
  --url https://telemetry.betterstack.com/api/v2/sources/95/aws-log-group-subscriptions \
  --header "Authorization: Bearer $TOKEN"


Create a log group subscription

Creates an override that subscribes or unsubscribes one log group.

POST https://telemetry.betterstack.com/api/v2/sources/{source_id}/aws-log-group-subscriptions

URL parameters

source_id
required string

ID of the aws source

Headers

Authorization
required string

Bearer $TOKEN

Body parameters

region
required string

AWS region of the log group, for example us-east-1.

name
required string

Name of the CloudWatch log group, for example /aws/lambda/checkout.

subscribed
required boolean

Whether to ingest this log group. Set to true to subscribe or false to skip it.

201

The subscription override was created.

Response body

{
  "data": {
    "id": "1",
    "type": "aws_log_group_subscription",
    "attributes": {
      "region": "us-east-1",
      "name": "/aws/lambda/checkout",
      "subscribed": true,
      "created_at": "2026-08-19T12:30:41.695Z",
      "updated_at": "2026-08-19T12:30:41.695Z"
    }
  }
}
422

An override already exists for this region and log group name.

Response body

{
  "errors": [
    "Name has already been taken"
  ],
  "invalid_attributes": [
    "name"
  ]
}

Example cURL

Create a log group subscription
curl --request POST \
  --url https://telemetry.betterstack.com/api/v2/sources/95/aws-log-group-subscriptions \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "region": "us-east-1",
    "name": "/aws/lambda/checkout",
    "subscribed": true
  }'


Get a single log group subscription

Returns one log group subscription override.

GET https://telemetry.betterstack.com/api/v2/sources/{source_id}/aws-log-group-subscriptions/{id}

URL parameters

source_id
required string

ID of the aws source

id
required string

ID of the log group subscription override

Headers

Authorization
required string

Bearer $TOKEN

200

Response body

{
  "data": {
    "id": "1",
    "type": "aws_log_group_subscription",
    "attributes": {
      "region": "us-east-1",
      "name": "/aws/lambda/checkout",
      "subscribed": true,
      "created_at": "2026-08-19T12:30:41.695Z",
      "updated_at": "2026-08-19T12:30:41.695Z"
    }
  }
}
404

The source has no subscription override with the given ID.

Response body

{
  "errors": "Resource with provided ID was not found"
}

Example cURL

Get a log group subscription
curl --request GET \
  --url https://telemetry.betterstack.com/api/v2/sources/95/aws-log-group-subscriptions/1 \
  --header "Authorization: Bearer $TOKEN"


Update a log group subscription

Subscribes or unsubscribes an existing override.

PATCH https://telemetry.betterstack.com/api/v2/sources/{source_id}/aws-log-group-subscriptions/{id}

URL parameters

source_id
required string

ID of the aws source

id
required string

ID of the log group subscription override

Headers

Authorization
required string

Bearer $TOKEN

Body parameters

subscribed
required boolean

Whether to ingest this log group. Set to true to subscribe or false to skip it.

200

The subscription override was updated.

Response body

{
  "data": {
    "id": "1",
    "type": "aws_log_group_subscription",
    "attributes": {
      "region": "us-east-1",
      "name": "/aws/lambda/checkout",
      "subscribed": false,
      "created_at": "2026-08-19T12:30:41.695Z",
      "updated_at": "2026-08-19T13:05:12.104Z"
    }
  }
}
404

The source has no subscription override with the given ID.

Response body

{
  "errors": "Resource with provided ID was not found"
}

Example cURL

Update a log group subscription
curl --request PATCH \
  --url https://telemetry.betterstack.com/api/v2/sources/95/aws-log-group-subscriptions/1 \
  --header "Authorization: Bearer $TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "subscribed": false
  }'


Delete a log group subscription

Removes the override and returns the log group to automatic behavior.

DELETE https://telemetry.betterstack.com/api/v2/sources/{source_id}/aws-log-group-subscriptions/{id}

URL parameters

source_id
required string

ID of the aws source

id
required string

ID of the log group subscription override

Headers

Authorization
required string

Bearer $TOKEN

204

The subscription override was deleted.

404

The source has no subscription override with the given ID.

Response body

{
  "errors": "Resource with provided ID was not found"
}

Example cURL

Delete a log group subscription
curl --request DELETE \
  --url https://telemetry.betterstack.com/api/v2/sources/95/aws-log-group-subscriptions/1 \
  --header "Authorization: Bearer $TOKEN"