Integrate with Hosted Graphite to gain insights into how your website or web application performs in different environments and under different conditions. is an open-source tool that runs on Docker and can be used for analyzing website performance helping you identify bottlenecks, and optimize your web pages. Sitespeed has a Graphite output and can be easily configured to send metrics to your Hosted Graphite account.

Send Sitespeed Metrics to Hosted Graphite

You can run the following Docker command against any website URL that you wish to test:

docker run --rm -v "$(pwd)":/ sitespeedio/ <URL-of-website-to-test> --graphite.port 2003 --graphite.namespace <YOUR-API-KEY>.sitespeed_io.default.hg

Running this command will send website performance metrics to your Hosted Graphite account and you can easily visualize them by importing various auto-dashboards from the Sitespeed GitHub repository. We also have a Sitespeed Performance dashboard that has been optimized for Hosted Graphite, located in our Dashboard Library. Event data will also be stored locally after each run, so it is recommended to run the command from within a designated directory.

Sending Annotations

To send Sitespeed annotations to Hosted Graphite you must add some required configuration options to your docker run command, such as:

--graphite.proxyPath /api/v1/graphite/events/
--graphite.httpPort 443
--graphite.auth <YOUR-API-KEY>:
--graphite.sendAnnotation true

Additionally, you can create a file at the root of your sitespeed directory named config.json to store all of the required --graphite options and run a cleaner command. Here is a template for a config.json file with all of the required Graphite options to include annotations, and a parameter that better aligns the annotations with our default aggregation resolution of 30s:

  "graphite": {
    "host": "",
    "port": 2003,
    "namespace": "<YOUR-API-KEY>.sitespeed_io.default.hg",
    "webHost": "",
    "proxyPath": "/api/v1/graphite/events/",
    "httpPort": 443,
    "auth": "<YOUR-API-KEY>:",
    "sendAnnotation": true,
    "annotationRetentionMinutes": ".5" 
   "resultBaseURL": ""

Save the file then run the Docker command using the --config option:

docker run --rm -v "$(pwd)":/ sitespeedio/ <URL-of-website-to-test> --config config.json

Additionally, you could run Sitespeed tests against multiple URL's by listing them in a separate file and including it in the docker run command:

Create a new file: urls.txt


Save the file and run the Docker command with the new file name in place of the URL:

docker run --rm -v "$(pwd)":/ sitespeedio/ urls.txt --config config.json

To only run 1 iteration of tests instead the default iteration of 3, that can also be specified in the docker run command by using the -n flag:

docker run --rm -v "$(pwd)":/ sitespeedio/ urls.txt --config config.json -n 1

Visualizing Annotations

Default annotations are sent by Sitespeed with tags that will match the following dashboard variables, as defined in the Sitespeed Performance dashboard:

$base $path $group $page $browser $connectivity $testname

These tags can be located in the Go to result annotation rule in the Page Metrics Auto Dash:

These default tags allow you to toggle between domains and visualize event annotations that correspond to each URL that Sitespeed was run against. Generally you only need to query the $base $group $page $browser $connectivity variables to see annotations on the Sitespeed Performance dashboard (annotations might not appear as expected with every default variable in place).

Last updated