From 49cc4210e0b5c916be152876c28a6908a94cca06 Mon Sep 17 00:00:00 2001 From: shalper2 Date: Mon, 25 Sep 2023 15:06:00 -0500 Subject: [PATCH] added readme --- receiver/splunkenterprisereceiver/README.md | 39 +++++++++++++++++-- .../testdata/config.yaml | 3 +- 2 files changed, 37 insertions(+), 5 deletions(-) diff --git a/receiver/splunkenterprisereceiver/README.md b/receiver/splunkenterprisereceiver/README.md index 15ab877aef4e..e45319366868 100644 --- a/receiver/splunkenterprisereceiver/README.md +++ b/receiver/splunkenterprisereceiver/README.md @@ -1,5 +1,38 @@ # Splunk Enterprise Receiver ---- -The Splunk Enterprise Receiver is a pull based tool which enables the ingestion of key performance metrics (KPI's) describing the operational status of a user's Splunk Enterprise deployment to be -added to their OpenTelemetry Pipeline. +The Splunk Enterprise Receiver is a pull based tool which enables the ingestion of performance metrics describing the operational status of a user's Splunk Enterprise deployment to an appropriate observability tool. +It is designed to leverage several different data sources to gather these metrics including the [introspection api endpoint](https://docs.splunk.com/Documentation/Splunk/9.1.1/RESTREF/RESTintrospect) and serializing +results from ad-hoc searches. Because of this, care must be taken by users when enabling metrics as running searches can effect your Splunk Enterprise Deployment and introspection may fail to report for Splunk +Cloud deployments. The primary purpose of this receiver is to empower those tasked with the maintenance and care of a Splunk Enterprise deployment to leverage opentelemetry and their observability toolset in their +jobs. + +## Configuration + +The following settings are required, omitting them will either cause your receiver to fail to compile or result in 4/5xx return codes during scraping. + +* `basicauth` (from [basicauthextension](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/extension/basicauthextension)): A configured stanza for the basicauthextension. +* `auth` (no default): String name referencing your auth extension. +* `endpoint` (no default): your Splunk Enterprise host's endpoint. + +The following settings are optional: + +* `collection_interval` (default: 10m): The time between scrape attempts. +* `timeout` (default: 60s): The time the scrape function will wait for a response before returning empty. + +Example: + +```yaml +extensions: + basicauth/client: + client_auth: + username: admin + password: securityFirst + +receivers: + splunkenterprise: + auth: basicauth/client + endpoint: "https://localhost:8089" + timeout: 45s +``` + +For a full list of settings exposed by this receiver please look [here](./config.go) with a detailed configuration [here](./testdata/config.yaml). diff --git a/receiver/splunkenterprisereceiver/testdata/config.yaml b/receiver/splunkenterprisereceiver/testdata/config.yaml index 22b764d3070a..48bf9742b416 100644 --- a/receiver/splunkenterprisereceiver/testdata/config.yaml +++ b/receiver/splunkenterprisereceiver/testdata/config.yaml @@ -7,8 +7,7 @@ basicauth/client: splunkenterprise: # required settings auth: basicauth/client # must use basicauthextension - endpoint: "https://localhost:8089" - # Optional settings + endpoint: "https://localhost:8089" # Optional settings collection_interval: 10s timeout: 11s # Also optional: metric settings