Skip to content

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

License

Notifications You must be signed in to change notification settings

SolarCS/fluent-plugin-google-cloud

 
 

Repository files navigation

CIPHER NOTE

Some of this gem’s dependencies’ versions are incompatible with the current dependencies in both Banff and CallServer. The highest version that didn’t run into any incompatibilites was too old, and the minimum (and ideal) version we need is 0.7.22, so we checked-out a new branch from that version and updated the dependencies to serve our needs. Furthermore, since there is already a GCP account being used in both projects and we want to try to avoid using different service accounts across multiple projects (eventually it would become too chaotic), another change introduced here is to rename the environment variable used to authenticate the provided service account

Updated dependencies:

  • googleapis-common-protos: from '1.3.9' to '1.3.10'

  • googleauth: from '0.9.0' to '~> 0.9'

  • google-api-client: from '0.30.8' to '~> 0.26'

  • grpc: from '1.22' to '~> 1.25.0'

  • google-protobuf: from '3.9.0' to '~> 3.12'

Google Cloud Logging plugin for fluentd

fluent-plugin-google-cloud gem includes two plugins:

  1. A filter plugin for fluentd that embeds insertIds into log entries to guarantee order and uniqueness.

  2. 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 embed insertIds into log entries, specify @type add_insert_ids in a filter clause of your Fluentd configuration file, for example:

<filter **>
  @type add_insert_ids
  insert_id_key my_insert_id_field_name # Optional.
</filter>

insert_id_key can be used to customize the insertId field name.

To send logs to Google Cloud Logging, specify @type google_cloud in a match clause of your Fluentd configuration file, for example:

<match **>
  @type google_cloud
</match>

See detailed instructions on how to configure this output plugin here. The plugin uses Google Application Default Credentials for authorization - for additional information see here.

Copyright

Copyright 2014 Google Inc. All rights reserved.

License

Apache License, Version 2.0

About

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

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Ruby 100.0%