Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

New component: Sematext Exporter #36465

Open
3 tasks done
AkhigbeEromo opened this issue Nov 20, 2024 · 1 comment
Open
3 tasks done

New component: Sematext Exporter #36465

AkhigbeEromo opened this issue Nov 20, 2024 · 1 comment
Labels
needs triage New item requiring triage Sponsor Needed New component seeking sponsor

Comments

@AkhigbeEromo
Copy link

AkhigbeEromo commented Nov 20, 2024

The purpose and use-cases of the new component

The Sematext Metric Exporter component is designed to export telemetry data, specifically metrics, to the Sematext platform, enabling real-time monitoring, alerting, and observability. This exporter is an extension of the existing InfluxDB exporter, leveraging Sematext's capability to listen over the Influx line protocol.

The primary changes include:

  • Addition of an app_token for authentication with the Sematext platform.
  • Introduction of Region to specify the data storage location.

Example configuration for the component

Configuration Options

  • timeout (default = 5s) Timeout for requests

  • Region Specifies the Sematext region the user is operating in; must be one of:

    • US
    • EU
  • app_token Specifies the token of the Sematext Monitoring App to which the user wants to send data.

  • payload_max_lines (default = 1,000) Maximum number of lines allowed per HTTP POST request.

  • payload_max_bytes (default = 300,000) Maximum number of bytes allowed per HTTP POST request.

  • metrics_schema (default = telegraf-prometheus-v2) The chosen metrics schema to write.

  • sending_queue Details here

    • enabled (default = true) Enables the sending queue.
    • num_consumers (default = 10) The number of consumers from the queue.
    • queue_size (default = 1000) Maximum number of batches allowed in the queue at a given time.
  • retry_on_failure Details here

    • enabled (default = true) Enables retries on failure.
    • initial_interval (default = 5s) Time to wait after the first failure before retrying.
    • max_interval (default = 30s) Upper bound on backoff interval.
    • max_elapsed_time (default = 120s) Maximum amount of time (including retries) spent trying to send a request/batch.

The full list of settings exposed for this exporter are documented in config.go.

Example:

timeout: 500ms
region: US  
retry_on_failure:
  enabled: true
  initial_interval: 1s
  max_interval: 3s
  max_elapsed_time: 10s
metrics:
  app_token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
  sending_queue:
    enabled: true
    num_consumers: 3
    queue_size: 10
  payload_max_lines: 100
  payload_max_bytes: 1000

Telemetry data types supported

Metrics

Is this a vendor-specific component?

  • This is a vendor-specific component
  • If this is a vendor-specific component, I am a member of the OpenTelemetry organization.
  • If this is a vendor-specific component, I am proposing to contribute and support it as a representative of the vendor.

Code Owner(s)

@AkhigbeEromo

Sponsor (optional)

No response

Additional context

No response

@AkhigbeEromo AkhigbeEromo added needs triage New item requiring triage Sponsor Needed New component seeking sponsor labels Nov 20, 2024
@AkhigbeEromo
Copy link
Author

@andrzej-stencel does this look good now and can this issue be assigned to me

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
needs triage New item requiring triage Sponsor Needed New component seeking sponsor
Projects
None yet
Development

No branches or pull requests

1 participant