LOG IN SIGN UP
Documentation

Log streaming: Cloud Files

Fastly's Real-Time Log Streaming feature can send log file to Cloud Files. Operated by Rackspace, Cloud Files is a file storage service used by developers and IT teams.

Prerequisites

If you don't already have a Rackspace Cloud account, you'll need to register for one. Follow the instructions on Rackspace's website.

Creating a Cloud Files user and container

Start by creating a Cloud Files user with restricted permissions via Rackspace's cloud control panel.

  1. Log in to Rackspace's cloud control panel.
  2. From the user account menu, select User Management.
  3. Click Create User and fill in all appropriate details.
  4. In the Product Access section, set User Role to Custom.
  5. Review the Product Access list. For all items in the Product column, set Role to No Access except the Files item.
  6. Set the Files item Role to Admin. This will allow you to create the files to store the logs in, but not access any other services.

Next, find the API key for your Cloud Files account. You'll use this later to authenticate using the Cloud Files API.

  1. From the user account menu, select Account Settings.
  2. Show the API key in the Login details and make a note of it.

Now that you've created the Cloud Files user and found the API key, you can set up a Cloud Files container.

  1. From the Storage menu, select Files.
  2. Click Create Container.
  3. Assign the container a meaningful name like Fastly logs - my service.
  4. Choose a region to keep the files in and make sure the container is private.
  5. Click Create Container.

Adding a Cloud Files logging endpoint

Once you have created the Cloud Files user and container, follow these instructions to add Cloud Files as a logging endpoint:

  1. Review the information in our Setting Up Remote Log Streaming guide.
  2. On the Logging page, find the Cloudfiles area and click New.

    New Cloud Files endpoint button

    The New Cloudfiles endpoint window appears.

    New Cloud Files endpoint window

  3. Fill out the New Cloudfiles endpoint fields as follows:

    • In the Name field, type a human-readable name for the endpoint.
    • In the Container Name field, type the name of the Cloud Files container in which to store the logs.
    • In the User field, type the username of the Cloud Files user you created above.
    • In the Access Key field, type the API key you found above.
    • In the Path field, optionally type the path within the container to store the files. The path ends with a trailing slash. If this field is left empty, the files will be saved in the container's root path.
    • In the Period field, optionally type an interval (in seconds) to control how frequently your log files are rotated. This value defaults to 3600 seconds.
    • In the Gzip Level field, optionally type the level of gzip compression you want applied to the log files. You can specify any whole number from 1 (fastest and least compressed) to 9 (slowest and most compressed). This value defaults to 0 (no compression).
    • In the Format String field, optionally type an Apache-style string or VCL variables to use for log formatting. The Apache Common Log format string appears in this field by default. See our guidance on format strings for more information.
  4. Click Create to create the new logging endpoint.