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. 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 Page Metrics Auto 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:
Auto Dash Annotations
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 Page Metrics Auto Dash (annotations might not appear as expected with all of the default variables in place).
NOTE: when importing the Page Metrics Auto Dash, you must select the 'hostedgraphite' data source before saving.
Last modified 1mo ago