Fastly app installation guide¶
What data does it ingest?¶
The Fastly app collects data from two sources:
HTTPS Logging Endpoint which is configured on each service in Fastly and sends request logs to an Observe ingestion endpoint
The Observe poller for Fastly periodically collects data about the services that are configured in Fastly.
The sections below describe how to ingest data, install, and configure these collectors. For more about exploring this data see Fastly.
Setup¶
Install the Fastly app using the App section under Applications in the navigation bar.
![Fastly app installation page](../../../_images/app.png)
Figure 1 - Fastly app card
HTTPS Logging Endpoint Setup¶
In Fastly, set up a logging endpoint for your Fastly service. As traffic is served, request logs will then be sent to Observe.
To configure a logging endpoint for your service, navigate to the configuration page for any service in Fastly.
Select
Logging
in the left side navigation menu.
![Fastly logging endpoint](../../../_images/fastly-logging.png)
Figure 2 - Fastly logging endpoint setup
2. Create a new logging endpoint. When prompted on which type of logging endpoint to create, scroll down to the HTTPS
option.
![Fastly logging endpoint](../../../_images/fastly-choose-logging.png)
Figure 3 - Create Fastly logging endpoint
![Fastly logging endpoint](../../../_images/fastly-https-endpoint.png)
Figure 4 - Fastly HTTPS logging endpoint
3. Configure the following settings:
* URL: https://${OBSERVE_CUSTOMER?}.collect.${OBSERVE_DOMAIN?}/v1/http/fastly/logs
![Fastly HTTPS endpoint config](../../../_images/fastly-endpoint-config-1.png)
Figure 5 - Fastly HTTPS logging endpoint configuration
4. Under Advanced Settings
, configure the following settings:
* **Content type**: `application/json`
* **Custom header name**: `Authorization`
* **Custom header value**: `${OBSERVE_TOKEN?}`
* **Method**: `POST`
Then save the configuration. Fastly should start sending logs to the Observe HTTP ingestion endpoint and within a few minutes you should see data start to populate in the datastream and datasets.
![Fastly HTTPS endpoint config](../../../_images/fastly-endpoint-config-2.png)
Figure 6 - Fastly HTTPS endpoint advanced settings
Poller Configuration¶
Pollers periodically request data from the Fastly API, allowing ingestion of additional Fastly service metadata. In order to set up a Poller, you’ll need to first configure API credentials in Fastly.
After logging into Fastly, from the top right account dropdown menu, select
Account
.
![Fastly account](../../../_images/fastly-account.png)
Figure 7 - Fastly Account Settings
2. In the left hand navigation bar under Personal Profile
, select API Tokens
.
![Fastly account tokens](../../../_images/fastly-account-tokens.png)
Figure 8 - Fastly Account Tokens
3. Click the Create Token
button in the top right. Re-enter your password if necessary on the next page.
4. Configure the following settings:
* Type: Automation token
* Role: User
* Scope: Read-only access
* Access: All services on ${ACCOUNT_NAME}
* Expiration: Never expire
![Fastly API Token config](../../../_images/fastly-new-api-token.png)
Figure 9 - Fastly API Token Configuration
Then create the token. Make sure to copy the token and store it securely before moving on.
5. With the token we can now set up the API Poller connection. In Observe, select Applications
in the left hand navigation bar and then select the Fastly
app. Click Manage
and then Connections
. Finally, find the API Poller
connection and click Get started
.
![Observe configure connections](../../../_images/observe-configure-connections.png)
Figure 10 - Observe Connections Configuration
6. Configure the following settings:
* Fastly Token: ${FASTLY_API_TOKEN}
* Interval Duration: 10m0s
![Observe configure connections](../../../_images/observe-poller-options.png)
Figure 11 - Observe Connections Configuration
Then create the new poller. Once created, you should start to see data populate in the Service
dataset.