Monitoring account activity with event logs

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. For example, you can use them to:

• see who activated the most recent version of your service
• review who logged in to your account via the web interface
• learn which users have two-factor authentication enabled
• view recent service configuration setting changes

Use the Fastly API to retrieve a service's event logs or view a limited subset of those logs via the web interface.

Accessing event logs via 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.

   

Accessing event logs via the API

The /events API endpoint can be used to retrieve a service's event logs. You can filter these events 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:

1
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:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
{
  "data": [
      {
          "attributes": {
              "admin": false,
              "created_at": "2016-06-06T20:05:10Z",
              "customer_id": "x4xCwxxJxGCx123Rx5xTx",
              "description": "Version 2 was activated",
              "event_type": "version.activate",
              "ip": "127.0.0.0",
              "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.