Telemetry Exporter
Satellite supports three ways to export its own telemetry data, prometheus
, metrics-service
or pprof
.
Multiple export methods are supported simultaneously, separated by commas.
Prometheus
Start HTTP port to export the satellite telemetry metrics.
When the following configuration is completed, then the satellite telemetry metrics export to: http://localhost${SATELLITE_TELEMETRY_PROMETHEUS_ADDRESS}${SATELLITE_TELEMETRY_PROMETHEUS_ENDPOINT}
,
and all the metrics contain the cluster
, service
and instance
tag.
# The Satellite self telemetry configuration.
telemetry:
# The space concept for the deployment, such as the namespace concept in the Kubernetes.
cluster: ${SATELLITE_TELEMETRY_CLUSTER:satellite-cluster}
# The group concept for the deployment, such as the service resource concept in the Kubernetes.
service: ${SATELLITE_TELEMETRY_SERVICE:satellite-service}
# The minimum running unit, such as the pod concept in the Kubernetes.
instance: ${SATELLITE_TELEMETRY_SERVICE:satellite-instance}
# Telemetry export type, support "prometheus", "metrics_service", "pprof" or "none"
export_type: ${SATELLITE_TELEMETRY_EXPORT_TYPE:prometheus}
# Export telemetry data through Prometheus server, only works on "export_type=prometheus".
prometheus:
# The prometheus server address.
address: ${SATELLITE_TELEMETRY_PROMETHEUS_ADDRESS::1234}
# The prometheus server metrics endpoint.
endpoint: ${SATELLITE_TELEMETRY_PROMETHEUS_ENDPOINT:/metrics}
Metrics Service
Send the message to the gRPC service that supports SkyWalking’s native Meter protocol with interval.
When the following configuration is completed, send the message to the specified grpc-client
component at the specified time interval.
Among them, service
and instance
will correspond to the services and service instances in SkyWalking.
# The Satellite self telemetry configuration.
telemetry:
# The space concept for the deployment, such as the namespace concept in the Kubernetes.
cluster: ${SATELLITE_TELEMETRY_CLUSTER:satellite-cluster}
# The group concept for the deployment, such as the service resource concept in the Kubernetes.
service: ${SATELLITE_TELEMETRY_SERVICE:satellite-service}
# The minimum running unit, such as the pod concept in the Kubernetes.
instance: ${SATELLITE_TELEMETRY_SERVICE:satellite-instance}
# Telemetry export type, support "prometheus", "metrics_service", "pprof" or "none"
export_type: ${SATELLITE_TELEMETRY_EXPORT_TYPE:metrics_service}
# Export telemetry data through native meter format to OAP backend, only works on "export_type=metrics_service".
metrics_service:
# The grpc-client plugin name, using the SkyWalking native batch meter protocol
client_name: ${SATELLITE_TELEMETRY_METRICS_SERVICE_CLIENT_NAME:grpc-client}
# The interval second for sending metrics
interval: ${SATELLITE_TELEMETRY_METRICS_SERVICE_INTERVAL:10}
# The prefix of telemetry metric name
metric_prefix: ${SATELLITE_TELEMETRY_METRICS_SERVICE_METRIC_PREFIX:sw_stl_}
pprof
pprof can provide HTTP services to allow remote viewing of service execution status, helping you discover performance issues.
# The Satellite self telemetry configuration.
telemetry:
# Telemetry export type, support "prometheus", "metrics_service", "pprof" or "none"
export_type: ${SATELLITE_TELEMETRY_EXPORT_TYPE:pprof}
# Export pprof service for detect performance issue
pprof:
# The pprof server address.
address: ${SATELLITE_TELEMETRY_PPROF_ADDRESS::6060}