data-source/zipkin

6 notes, read out of this brain and free to use. Each one was extracted from a source and is re-checked against its exam.

Zipkin data source basic configuration settings

The Zipkin data source requires three basic configuration settings: Name (the name used to refer to the data source in panels and queries), Default (toggle to make this the default data source for new panels), and URL (the URL of the Zipkin instance, such as http://localhost:9411).

Zipkin data source authentication methods

The Zipkin data source supports four authentication methods: Basic authentication (username and password), TLS client authentication (client certificates for mutual TLS), Forward OAuth identity (forward the user's OAuth token to the Zipkin instance), and With credentials (send credentials including cookies and TLS client certificates with cross-site requests). Custom headers and TLS settings are configured in the Advanced HTTP settings section within Additional settings.

Zipkin trace to logs variables for custom queries

Variables for custom trace to logs queries are wrapped in ${}. Available variables are: __tags (interpolates mapped tags as a list in data source syntax, only including tags present in the span), __span.spanId (the ID of the span), __span.traceId (the ID of the trace), __span.duration (the duration of the span), __span.name (the name of the span), __span.tags (namespace for tags accessed as ${__span.tags.tagname} or ${__span.tags["tag.name"]} for tags with dots), __trace.traceId (the ID of the trace), __trace.duration (the duration of the trace), and __trace.name (the name of the trace).

Zipkin trace to logs configuration options

The trace to logs configuration has these settings: Data source (target data source: Loki, Elasticsearch, Splunk, OpenSearch, FalconLogScale, Google Cloud Logging, or VictoriaMetrics Logs), Span start time shift (shifts start time for logs query, use time units like 5s/1m/3h, use negative value to extend to past, default 0), Span end time shift (shifts end time for logs query, use time units, default 0), Tags (tags used in logs query, default: cluster, hostname, namespace, pod, service.name, service.namespace), Filter by trace ID (toggle to append trace ID to logs query), Filter by span ID (toggle to append span ID to logs query), Use custom query (toggle use of custom query with interpolation), Query (input for custom query using variable interpolation).

Zipkin trace to metrics configuration

Trace to metrics lets you navigate from a span in a trace view to a metrics query in a configured metrics data source. Configuration includes a Data source setting (defines the target data source) and Tags setting (defines tags used in linked queries where the key sets the span attribute name and optional value sets the corresponding metric label name). Each linked query consists of Link Label (optional descriptive label) and Query (the query run when navigating, interpolating tags using the $__tags keyword).

Zipkin node graph and span bar settings

The Node graph toggle enables the Node graph visualization (disabled by default), and when enabled, Grafana displays the node graph above the trace view. The Span bar setting displays additional information with a Label dropdown having three options: None (adds nothing), Duration (default, displays span duration on span bar row), and Tag (displays span tag on span bar row, requires entering the Tag key such as 'component').

Give your agent this brain