OpenTelemetry Bot d680729c09 [chore] Prepare release 0.90.0 (#29543) 1 year ago
..
internal 91643ba261 [mdatagen] allow adding resource_attribute warnings (#27257) 1 year ago
testdata 30024d9e07 Splunkent client refactor (#27205) 1 year ago
Makefile 703f0490fd Splunk Enterprise Wireframe (#21976) 1 year ago
README.md 30024d9e07 Splunkent client refactor (#27205) 1 year ago
client.go 30024d9e07 Splunkent client refactor (#27205) 1 year ago
client_test.go 30024d9e07 Splunkent client refactor (#27205) 1 year ago
config.go 30024d9e07 Splunkent client refactor (#27205) 1 year ago
config_test.go 30024d9e07 Splunkent client refactor (#27205) 1 year ago
doc.go a3eacd62df [receiver/splunkenterprise] Add scraping of two initial metrics (#24800) 1 year ago
documentation.md 52e2bb8a3f [receiver/splunkenterprise] Additional API metrics (#26728) 1 year ago
factory.go 30024d9e07 Splunkent client refactor (#27205) 1 year ago
factory_test.go 30024d9e07 Splunkent client refactor (#27205) 1 year ago
go.mod d680729c09 [chore] Prepare release 0.90.0 (#29543) 1 year ago
go.sum 40b485f08a Update core for v0.90.0 release (#29539) 1 year ago
metadata.yaml 52e2bb8a3f [receiver/splunkenterprise] Additional API metrics (#26728) 1 year ago
scraper.go 30024d9e07 Splunkent client refactor (#27205) 1 year ago
scraper_test.go cd92432fd2 [pkg/golden] internal/coreinternal/golden -> pkg/golden (#28636) 1 year ago
search_result.go 52e2bb8a3f [receiver/splunkenterprise] Additional API metrics (#26728) 1 year ago

README.md

Splunk Enterprise Receiver

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 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): 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:

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 with a detailed configuration here.