Monitoring account activity with event logs

  Last updated August 14, 2018

Event logs keep track of events related to your services, account, and users. You can use event logs to determine which changes were made and by whom. Event logs are available for retrieval via the Fastly API. A limited subset of your services' event logs are also available within the web interface. Event log data is currently retained indefinitely.

Types of events that are logged

Event logs record many types of events that users can perform:

When event logs might be useful

Accessing event logs

There are two ways to access event logs: by using the Fastly API or by viewing the latest events in the web interface. The events displayed in the web interface are a subset of those available via the API.

Using the API

You can use the /events API endpoint to access your event logs. Events can be filtered by user_id, service_id, customer_id, and event_type. For example, you could make the following API call in a terminal application to view all recent events:

curl -g -H "Fastly-Key: FASTLY_API_TOKEN" https://api.fastly.com/events?filter[customer_id]=x4xCwxxJxGCx123Rx5xTx&page[number]=1&page[size]=1

The response will look like this:

  "data": [
          "attributes": {
              "admin": false,
              "created_at": "2016-06-06T20:05:10Z",
              "customer_id": "x4xCwxxJxGCx123Rx5xTx",
              "description": "Version 2 was activated",
              "event_type": "version.activate",
              "ip": "",
              "metadata": {
                  "version_number": 2
              "service_id": "SU1Z0isxPaozGVKXdv0eY",
              "user_id": "4Pp0BW3UkBEJhG3N0kovLP"
          "id": "5IH1QmNSV1Qi7jXc4oIZlZ",
          "type": "event"
  "links": {
    "last": "https://api.fastly.com/events?filter[customer_id]=x4xCwxxJxGCx123Rx5xTx&page[number]=1&page[size]=1"

See the API documentation for more information.

Using the web interface

The web interface displays the last 20 service-related events for the selected service. Events related to users and accounts are not displayed in the web interface.

Follow these instructions to access the event logs for a service:

  1. Log in to the Fastly web interface and click the Configure link.
  2. The most recent service-related events are displayed near the bottom of the page, in the Event log area.

    Service Event log

Back to Top