Skip to content

mia-0032/fluent-plugin-stackdriver-monitoring

Repository files navigation

fluent-plugin-stackdriver-monitoring

Stackdriver Monitoring custom metrics output plugin for Fluentd

Installation

$ gem install fluent-plugin-stackdriver-monitoring

Authentication

See google-cloud-monitoring gem document.

Configuration

Sample configuration is below.

<match your.tag>
  @type stackdriver_monitoring
  project {{PROJECT_NAME}}

  <custom_metrics>
    key {{KEY_NAME}}
    type custom.googleapis.com/{{METRICS_NAME}}
    metric_kind GAUGE
    value_type INT64
  </custom_metrics>

  flush_interval 1s  # must be 1(sec) or above
</match>
  • project (string, required)
    • Set your Stackdriver project id.
  • custom_metrics
    • key (string, required)
      • Specify field name in your log to send to Stackdriver.
    • type (string, required)
      • Set name of descriptor. It must start with custom.googleapis.com/.
    • metric_kind(enum, required)
      • See metric kind.
      • You can specify GAUGE or CUMULATIVE.
      • Custom metric does not support DELTA. See here.
    • value_type(enum, required)
      • See value type.
      • You can specify BOOL, INT64 or DOUBLE if metric_kind is GAUGE. And INT64 or DOUBLE can be specified if metric_kind is CUMULATIVE.
      • Custom metric does not support MONEY and STRING. See here.
    • time_interval(time, optional)
      • This param is used as the difference between start time and end time.
      • It must be greater than 0s if metric_kind is set to CUMULATIVE.

TODO

  • Add test!
  • Support Unit and Monitored Resource in custom_metrics.

About

Stackdriver Monitoring custom metrics output plugin for Fluentd

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages