Skip to content

splunk/fluent-plugin-k8s-metrics-agg

Repository files navigation

End of Support

Important: The fluent-plugin-k8s-metrics-agg will reach End of Support on January 1, 2024. After that date, this repository will no longer receive updates from Splunk and will no longer be supported by Splunk. Until then, only critical security fixes and bug fixes will be provided.

Fluentd Plugin for Kubernetes Metrics - Aggregator

Fluentd input plugin collects kubernetes cluster metrics from the kubeapiserver API. The API is exposed by KubeApiServer on a kubernetes cluster.

Installation

See also: Plugin Management.

RubyGems

$ gem install fluent-plugin-k8s-metrics-agg

Bundler

Add following line to your Gemfile:

gem "fluent-plugin-k8s-metrics-agg"

And then execute:

$ bundle

Plugin helpers

Fluent::Plugin::KubernetesMetricsAggregatorInput

tag (string) (optional)

The event tag.

Default value: kubernetes.metrics.*.

interval (time) (optional)

How often the plugin pulls metrcs.

Default value: 15s.

kubeconfig (string) (optional)

The path to a kubeconfig file points to a cluster from which the plugin should collect metrics. This is mostly useful when running fluentd outside of the cluster. When kubeconfig is set, the kubernetes_url, client_cert, client_key, ca_file, insecure_ssl, bearer_token_file, and secret_dir are ignored.

client_cert (string) (optional)

The path to the certificate file for this client.

client_key (string) (optional)

The path to the private key file for this client.

ca_file (string) (optional)

The path to the CA file.

insecure_ssl (bool) (optional)

When insecure_ssl is set to true, the plugin does not verify the apiserver's certificate.

bearer_token_file (string) (optional)

The path to the file contains the API token. By default the plugin reads from the file "token" in the secret_dir.

secret_dir (string) (optional)

The path to the location of the pod's service account credentials.

Default value: /var/run/secrets/kubernetes.io/serviceaccount.

kubelet_port (integer) (optional)

The port that the kubelet is listening to.

Default value: 10255.

cluster_name (string) (optional)

The name of the cluster where the plugin is deployed.

Default value: cluster_name.

License

See License.