@@ -20,7 +20,7 @@ The API is a set of classes and interfaces for recording telemetry across key
2020observability signals. The [ SDK] ( ../sdk/ ) is the built-in reference
2121implementation of the API, [ configured] ( ../configuration/ ) to process and export
2222telemetry. This page is a conceptual overview of the API, including
23- descriptions, links to relevant Javadocs, artifact coordinates, sample API
23+ descriptions, links to relevant Javadocs, artifact coordinates, and sample API
2424usage.
2525
2626The API consists of the following top-level components:
@@ -79,7 +79,7 @@ It consists of:
7979 propagating ` Context ` across application boundaries.
8080
8181The ` io.opentelemetry:opentelemetry-extension-kotlint:{{% param vers.otel %}} `
82- is an extension with tool for propagating context into coroutines.
82+ is an extension with tools for propagating context into coroutines.
8383
8484### Context
8585
@@ -96,7 +96,7 @@ argument. Context is a recurring concept in the OpenTelemetry API:
9696 [ exemplars] ( /docs/specs/otel/metrics/data-model/#exemplars ) and defaulting to
9797 whatever span is currently in context.
9898- [ LogRecords] ( #logrecordbuilder ) accept a context argument, used to link log
99- records spans and defaulting to whatever span is currently in context.
99+ record spans and defaulting to whatever span is currently in context.
100100
101101The following code snippet explores ` Context ` API usage:
102102
@@ -383,8 +383,8 @@ scope:
383383{{% alert %}} {{% param logBridgeWarning %}} {{% /alert %}}
384384
385385A scope is identified by the triplet (name, version, schemaUrl). Care must be
386- taken to ensure to the scope identity is unique. A typical approach is to set
387- the scope name to the package name or fully qualified class name, and to set the
386+ taken to ensure the scope identity is unique. A typical approach is to set the
387+ scope name to the package name or fully qualified class name, and to set the
388388scope version to the library version. If emitting telemetry for multiple signals
389389(i.e. metrics and traces), the same scope should be used. See
390390[ instrumentation scope] ( /docs/concepts/instrumentation-scope/ ) for details.
@@ -455,10 +455,9 @@ is a bundle of key value pairs representing the
455455[ standard attribute definition] ( /docs/specs/otel/common/#standard-attribute ) .
456456` Attributes ` are a recurring concept in the OpenTelemetry API:
457457
458- - [ Spans] ( #span ) , span events, and span links have attributes
459- - The measurements recorded to [ metric instruments] ( #meter ) have attributes
460- - [ LogRecords] ( #logrecordbuilder ) have attributes
461- - and more
458+ - [ Spans] ( #span ) , span events, and span links have attributes.
459+ - The measurements recorded to [ metric instruments] ( #meter ) have attributes.
460+ - [ LogRecords] ( #logrecordbuilder ) have attributes.
462461
463462See [ semantic attributes] ( #semantic-attributes ) for attribute constants
464463generated from the semantic conventions.
@@ -653,7 +652,7 @@ public class GlobalOpenTelemetryUsage {
653652### TracerProvider
654653
655654[ TracerProvider] ( https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-api/latest/io/opentelemetry/api/trace/TracerProvider.html )
656- is the API entry point for traces, and provides [ Tracers] ( #tracer ) . See
655+ is the API entry point for traces and provides [ Tracers] ( #tracer ) . See
657656[ providers and scopes] ( #providers-and-scopes ) for information on providers and
658657scopes.
659658
@@ -772,13 +771,13 @@ public class SpanUsage {
772771
773772Span parenting is an important aspect of tracing. Each span has an optional
774773parent. By collecting all the spans in a trace and following each span's parent,
775- we can construct a hierarchy. The span APIs are build on top of
774+ we can construct a hierarchy. The span APIs are built on top of
776775[ context] ( #context ) , which allows span context to be implicitly passed around an
777776application and across threads. When a span is created, its parent is set to the
778777whatever span is present in ` Context.current() ` unless there is no span or the
779778context is explicitly overridden.
780779
781- Most of the context API usage guidance applies to span . Span context is
780+ Most of the context API usage guidance applies to spans . Span context is
782781propagated across application boundaries with the
783782[ W3CTraceContextPropagator] ( https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-api/latest/io/opentelemetry/api/trace/propagation/W3CTraceContextPropagator.html )
784783and other [ TextMapPropagators] ( ../sdk/#textmappropagator ) .
@@ -847,7 +846,7 @@ public class SpanAndContextUsage {
847846### MeterProvider
848847
849848[ MeterProvider] ( https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-api/latest/io/opentelemetry/api/metrics/MeterProvider.html )
850- is the API entry point for metrics, and provides [ Meters] ( #meter ) . See
849+ is the API entry point for metrics and provides [ Meters] ( #meter ) . See
851850[ providers and scopes] ( #providers-and-scopes ) for information on providers and
852851scopes.
853852
@@ -858,7 +857,7 @@ is used to obtain instruments for a particular
858857[ instrumentation scope] ( #providers-and-scopes ) . See
859858[ providers and scopes] ( #providers-and-scopes ) for information on providers and
860859scopes. There are a variety of instruments, each with different semantics and
861- default behavior in the SDK. Its important to choose the right instrument for
860+ default behavior in the SDK. It's important to choose the right instrument for
862861each particular use case:
863862
864863| Instrument | Sync or Async | Description | Example | Default SDK Aggregation |
@@ -1328,7 +1327,7 @@ public class AsyncGaugeUsage {
13281327### LoggerProvider
13291328
13301329[ LoggerProvider] ( https://www.javadoc.io/doc/io.opentelemetry/opentelemetry-api/latest/io/opentelemetry/api/logs/LoggerProvider.html )
1331- is the API entry point for logs, and provides [ Loggers] ( #logger ) . See
1330+ is the API entry point for logs and provides [ Loggers] ( #logger ) . See
13321331[ providers and scopes] ( #providers-and-scopes ) for information on providers and
13331332scopes.
13341333
0 commit comments