Hosted Graphite Docs
Get StartedBook a Demo
  • Welcome to Hosted Graphite
  • Getting Started
  • HG-CLI
  • Sending Metrics
    • Supported Protocols
    • Graphite Tag Support
    • Metric Management
    • Metric APIs
  • Language Guide
    • Metric Libraries
    • .NET
    • Go
    • Java
    • Javascript
    • Node.js
    • PHP
    • Postman
    • Python 2.x
    • Python 3.x
    • Python Pickle
    • Ruby
    • Shell
    • TypeScript
  • Dashboard and Graphs
    • Primary Dashboards
    • Dashboard Library
    • Local Dashboard Integration
    • Worldmap Panel
    • Graphite Dashboard Guide
    • Graphite Graph Menu Reference
    • Other Dashboard Options
  • Alerting Guide
    • Alerting Overview
    • Alerts API
    • Notification Channels API
    • Scheduled Mutes API
    • Using Your Own Alerting
  • Agents Guide
    • The Hosted Graphite Agent
      • Base Metrics
      • System Layout
    • Telegraf
    • K8 Telegraf Daemon
    • OpenTelemetry
    • collectd Agent
    • StatsD Agent
    • Diamond
  • Add-Ons and Integrations Guide
    • AWS CloudWatch
    • Azure Monitor Metrics
    • GCP Metrics
    • Carbon-C-Relay
    • Circle CI
    • Cloudbees
    • Collectd Add Ons
    • GitHub
    • GitLab
    • Heroku
    • Hosted StatsD
    • New Relic
    • Papertrail
    • Pingdom
    • Sentry
    • Sitespeed
    • StatsD Add-on
    • Statuspage
  • Account Management
    • Access Keys
    • Account Diagnostics
    • Account Settings
    • Team Access: Limited Access Groups
    • SAML Authentication
    • Team Access
  • Additional Features
    • Aggregation Rules
    • Data Views
  • API Guides
    • Metrics API
    • Tag API
    • Graphite Render API
    • Render Variables API
    • Dashboard API
    • Annotations and Events API
    • Aggregation Rules API
    • Alerts APIs
  • FAQ
    • General
    • Business
    • Technical
    • Account Metrics and Limiting
    • Customization
    • Troubleshooting
    • Support
    • Changelog
Powered by GitBook
On this page

Was this helpful?

  1. Add-Ons and Integrations Guide

Sitespeed

Integrate Sitespeed.io with Hosted Graphite to gain insights into how your website or web application performs in different environments and under different conditions.

PreviousSentryNextStatsD Add-on

Last updated 6 months ago

Was this helpful?

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)":/sitespeed.io sitespeedio/sitespeed.io:29.2.0 <URL-of-website-to-test> --graphite.host carbon.hostedgraphite.com --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 . We also have a Sitespeed Performance dashboard that has been optimized for Hosted Graphite, located in our . 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

--graphite.webHost www.hostedgraphite.com
--graphite.proxyPath /api/v1/graphite/events/
--graphite.httpPort 443
--graphite.auth <YOUR-API-KEY>:
--graphite.resultBaseURL https://result.sitespeed.io
--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": "carbon.hostedgraphite.com",
    "port": 2003,
    "namespace": "<YOUR-API-KEY>.sitespeed_io.default.hg",
    "webHost": "www.hostedgraphite.com",
    "proxyPath": "/api/v1/graphite/events/",
    "httpPort": 443,
    "auth": "<YOUR-API-KEY>:",
    "sendAnnotation": true,
    "annotationRetentionMinutes": ".5" 
    },
   "resultBaseURL": "https://result.sitespeed.io"
}

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

docker run --rm -v "$(pwd)":/sitespeed.io sitespeedio/sitespeed.io:29.2.0 <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

  https://www.<url-1>.com/
  https://www.<url-2>.com/
  https://www.<url-3>.com/

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

docker run --rm -v "$(pwd)":/sitespeed.io sitespeedio/sitespeed.io:29.2.0 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)":/sitespeed.io sitespeedio/sitespeed.io:29.2.0 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).

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

configuration options
Sitespeed.io
repository
Dashboard Library
Sitespeed Performance Dashboard
Sitespeed Annotations