What's the difference between a counter stat and a value stat?

Counter stats sum up counts over time. Value stats average values over time.

For counter stats, you send StatHat a count whenever an event happens. When StatHat displays the data for a counter stat, it sums up the data over time. So when you look at a chart of a counter stat, each data point is the sum of the counts received over that time interval. A chart of "1 week @ 3 hours" shows one week of data where each data point is the sum of the counts received over a three hour period.

In addition to the standard min/max/mean data shown in the data summary tables for all stats, counter stats include a row showing the total count. This is very useful to see at a glance how many times an event occurred over the past hour, day, week, month, year.

Counter stats are good at tracking the occurrence of events. They don't make much sense for server load averages or the age of users.

When StatHat displays data for a value stat, it averages the data over the time interval. Each data point in a value stat chart of "1 week @ 3 hours" is the average of the values received over each three hour interval in the past week.

Value stats are best used for tracking things like load averages, time durations, scores, age.

Can I compare multiple stats in one chart?

Yes. Using the analyze interface, you can compare up to three stats at once. From the stat details page, press the "Analyze" button. You can save an analysis and come back to it at any time.

I deleted a stat. How can I get it back?

Go to the stats page and select the "trash" listing. You'll see all stats deleted in the past 48 hours. After 48 hours, they are deleted permanently.

What do the dashed lines in the charts mean?

The dashed line shows data for a time period in the past for comparison purposes. For example, the standard large chart on the stat details page shows one week of data, and the dashed line shows what it was one week ago.

What is a private stat?

A private stat can only be viewed by the owner of the stat while signed in. A public stat can be viewed by anyone.

Why do some stats not display the total?

Value stats don't display the total. Totals only make sense for counter stats.

How do I download my data?

On the stat details page, there is a "Download CSV" button.


Do you have a library for language XXX?

All of our language libraries are listed in the sidebar of this page.

If we don't have a library for a language you want to use, it's pretty easy to interact with StatHat. Check out the API Reference for details.

How long does it take an api call to get to a chart?

At most, two minutes.

Why does StatHat use an email address for the user key?

We wanted to make integration simple. Using email addresses for user keys makes it easy as there is no strange key to paste in to your code, just an email address that presumably you have memorized and a stat name.

That being said, you can change the key to anything you want, or StatHat can make a random one for you. Go to the settings page to do that.

We don't recommend using the EZ-API for anything like client-side JavaScript where your keys are in the clear. For that, use the Classic API keys.

Can I submit data over https?

Yes. All incoming data can come in over https. Just use as the endpoint.

Do you support UDP?

Not over the internet.

UDP is unreliable and will definitely result in lost packets. Making sure we get all your data is our top priority, so that is unacceptable. Besides that, there is no flow control.

You can run a proxy on your server that receives data over UDP and sends it to StatHat over HTTP. One of our users wrote one, check it out in the User Code Library.

Do you have a JSON API to get data out of StatHat?

Yes. Read about it here.


How do I customize an embedded chart?

Check out the Embed API Documentation.


What is a card?

Read all about cards here.


When are reports delivered?

At midnight in your time zone. You can set your time zone on the settings page.


Are there any usage restrictions?

Free accounts are limited to ten stats.

How much does StatHat cost?

$99/month for unlimited usage (technically speaking, 10,000 different stats), with no plans or tiers or other limits to worry about. Includes up-to-the-minute data, automatic alerts, and trend forecasts.

Can multiple people have access to one account?

Yes. The account owner can add members that can sign in with their own email address and password. The members have full access to everything except changing settings and viewing invoices. You can add and remove members on the settings page.


What does your stack look like?

We use Go for everything. You can read about why we chose Go and how we use it on The Go Programming Language Blog.

Check out StatHat Open Source for our public Go projects.

Still have a question?

Contact us at or @stathat. Thanks!

© 2011-2017 Numerotron Inc