witoff / fluent-plugin-google-cloud

Plugin for Fluentd that sends logs to the Google Cloud Platform's log ingestion API.

Google Cloud Logging plugin for fluentd¶ ↑

fluent-plugin-google-cloud is an output plugin for fluentd which sends logs to the Stackdriver Logging API.

This is an official Google Ruby gem.

<img src=“https://badge.fury.io/rb/fluent-plugin-google-cloud.svg” alt=“Gem Version” /> <img src=“https://secure.travis-ci.org/GoogleCloudPlatform/fluent-plugin-google-cloud.png” alt=“Build Status” />

Installation¶ ↑

This gem is hosted at RubyGems.org and can be installed using:

$ gem install fluent-plugin-google-cloud

Installing google-fluentd will also install and configure the gem.

Configuration¶ ↑

To send logs to Google Cloud Logging, specify type google_cloud in a match clause of your fluentd configuration file. Logs from most GCP and AWS runtimes can be sent with a default configuration, for example:

<match **>
  type google_cloud
</match>

For other environments that do not provide system information through a metadata service you will need to directly configure at minimum zone and VM identifiers, for example:

<match **>
  @type google_cloud
  use_metadata_service false
  zone "rack-1"
  vm_id "i-123"
</match>

No further configuration is required. The plugin uses Google Application Default Credentials for authorization - for additional information see here.

The previously documented parameters auth_method, private_key_email, and private_key_path are removed, and can no longer be used.

Copyright¶ ↑

Copyright

Copyright 2014 Google Inc. All rights reserved.

License

Apache License, Version 2.0