View Source Semantic Conventions for Runtime Environment
Status: Experimental
This document defines semantic conventions for
runtime environment spans, metrics and logs.
Metrics
Runtime environments vary widely in their terminology, implementation, and
relative values for a given metric. For example, Go and Python are both
garbage collected languages, but comparing heap usage between the Go and
CPython runtimes directly is not meaningful. For this reason, this document
does not propose any standard top-level runtime metric instruments. See OTEP
108 for additional
discussion.
Metrics specific to a certain runtime environment should be prefixed with
the runtime's top-level namespace {environment}.*, e.g., jvm.* and follow the
general metric semantic convention guidelines.
Authors of runtime instrumentations are responsible for the choice of{environment} to avoid ambiguity when interpreting a metric's name or values.
For example, some programming languages have multiple runtime environments
that vary significantly in their implementation, like Python which has many
implementations. For
such languages, consider using specific {environment} prefixes to avoid
ambiguity, like cpython.* and pypy.*.
Also consider the
general metrics,
system metrics and
OS process metrics
semantic conventions when instrumenting runtime environments.
Attributes
process.runtime
resource attributes SHOULD be included on runtime metric events as appropriate.