big-stats

0.2.47 • Public • Published

big stats Build Status NPM Version

a google big query backend for statsd

usage

Big stats can be npm installed onto your statsd host and then referenced in your statsd server's configuration under backends

cat config.json
{
  bigquery: {
    credentials: {
       ...
    },
    projectId: "your-gcp-project-id",
    datasetId: "your_big_query_data_set_id",
    tableId: "your_big_query_table_id"
  }
  , backends: ["big-stats"],
  , ...
}

Big stats is configured through a bigquery section of your statsd server configuration.

The "credentials" should be a set of google API service account credentials acquired through your google cloud console.

"projectId" and "datasetId" must be predefined in your console bigquery

"tableId" must be provided in as configuration by does not need to be preconfigured in your google cloud console. big-stats will create the table on the fly if not previously present.

You can optionally provide a "flushInterval" (in seconds) for how often you wish to flush to bigquery. The default is 120 seconds which factors in BigQuery's 1000 job per day quota limit. Note than statsd flushes in 10 second intervals by default.

schema

Big stats assumes a 4 column schema

name data type description
timestamp TIMESTAMP time stat was flushed
value FLOAT value associated with stat
key STRING user defined stat key
metric_type STRING metric type

Only user define stats will be published to big query. Statsd internal metrics, those prefixed with statsd., will be omitted.

Meetup 2016

Readme

Keywords

Package Sidebar

Install

npm i big-stats

Weekly Downloads

1

Version

0.2.47

License

MIT

Last publish

Collaborators

  • meetupbot