Edge Delta Self Telemetry Source

Configure the Edge Delta Self Telemetry Source to collect metrics from agent statistics and node health data.

Overview

The Edge Delta Self Telemetry source node produces metrics based on:

  • agent statistics,
  • incoming and outgoing stats for pipelines, and
  • health data of the nodes in the graph.

It feeds the the Edge Delta Destination, and is used to power the Metrics Explorer page and the per node throughput data on the Pipeline view. It can also send this data to other destinations. You should not remove this node as it will disable these features.

To see metrics generated by this node, use the Metrics Inventory and search by node name (opens Edge Delta).

Example Configuration

nodes:
- name: ed_self_telemetry_input
  type: ed_self_telemetry_input
  enable_health_metrics: true
  enable_agent_stats_metrics: true

links:
- from: ed_self_telemetry_input
  to: edgedelta

Data from this node does not contribute to your plan usage.

Required Parameters

name

A descriptive name for the node. This is the name that will appear in pipeline builder and you can reference this node in the YAML using the name. It must be unique across all nodes. It is a YAML list element so it begins with a - and a space followed by the string. It is a required parameter for all nodes.

nodes:
  - name: <node name>
    type: <node type>

type: ed_self_telemetry_input

The type parameter specifies the type of node being configured. It is specified as a string from a closed list of node types. It is a required parameter.

nodes:
  - name: <node name>
    type: <node type>

Optional Parameters

enable_health_metrics

The enable_health_metrics parameter defines whether to ingest health metrics. it is specified as a Boolean and the default value is true. The enable_health_metrics parameter is optional.

nodes:
- name: ed_self_telemetry_input
  type: ed_self_telemetry_input
  enable_health_metrics: true

enable_agent_stats_metrics

The enable_agent_stats_metrics parameter defines whether to ingest agent statistics metrics. it is specified as a Boolean and the default value is true. The enable_agent_stats_metrics parameter is optional.

nodes:
- name: ed_self_telemetry_input
  type: ed_self_telemetry_input
  enable_agent_stats_metrics: true

disable_intermediate_self_telemetry

The disable_intermediate_self_telemetry parameter controls whether to emit telemetry for intermediate pipeline nodes. When set to true, the node emits stats only for input and output nodes, skipping all intermediate processor and transform nodes. This reduces the volume of self-telemetry data and can help lower CPU and memory usage on the agent. It is specified as a Boolean and the default value is false.

nodes:
- name: ed_self_telemetry_input
  type: ed_self_telemetry_input
  disable_intermediate_self_telemetry: true

Tip: Enable this parameter in resource-constrained environments or when you don’t need per-node throughput visibility for intermediate pipeline nodes. See Reducing Agent Resource Consumption for more optimization strategies.

report_interval

The report_interval parameter defines how frequently self-telemetry stats are reported. It is specified as a duration string and the default value is 1m.

nodes:
- name: ed_self_telemetry_input
  type: ed_self_telemetry_input
  report_interval: 2m

source_metadata

The source_metadata parameter configures include/exclude options for metadata at the source level, right before adding it to the pipeline. It supports filtering both resource attributes and regular attributes.

nodes:
- name: ed_self_telemetry_input
  type: ed_self_telemetry_input
  source_metadata:
    resource_attributes:
      host.name: true    # Include this attribute
      host.id: false     # Exclude this attribute
    attributes:
      some.attribute: true

The source_metadata parameter has the following sub-parameters:

Sub-parameterDescription
resource_attributesMap of fields to persist or remove from the “resource” section of the outgoing item. Set to true to include, false to exclude.
attributesMap of fields to persist or remove from the “attributes” section of the outgoing item. Set to true to include, false to exclude.