NAME

OpenTelemetry::Constants - Constants used by OpenTelemetry

SYNOPSIS

use OpenTelemetry::Constants -span_status;
use OpenTelemetry::Constants
    -trace_export => { -as => sub { shift =~ s/^TRACE_EXPORT_//r } };

DESCRIPTION

This package includes constants used by different parts of OpenTelemetry.

It uses Exporter::Tiny to make it easier to export these symbols in a way that is most helpful depending on the context. Please look at the documentation of that module for details on what is supported.

CONSTANTS

Span Status Codes

These constants are used to specify the status of a span once it has completed. They can be imported individually, or with the span_status tag. They are also imported when using the span tag.

SPAN_STATUS_UNSET

The status of a span when no status has been set. This is the default value.

SPAN_STATUS_OK

The status of a span that has been marked as having completed successfully by an application.

SPAN_STATUS_ERROR

The status of a span that has been marked as not having completed successfully by an application.

Span Kinds

These constants are used to specify the type of the span. They can be imported individually, or with the span_kind tag. They are also imported when using the span tag.

SPAN_KIND_INTERNAL

The span is internal to an application, and is not at one of its boundaries (eg. with other applications). If no kind is specified, this is the default value.

SPAN_KIND_SERVER

The span covers the server-side handling of some remote network request.

SPAN_KIND_CLIENT

The span describes a request to a remote service.

SPAN_KIND_PRODUCER

The span describes a message sent to a broker. Unlike the client and server kinds above, the action represented by this span ends once the broker accepts the message, even if the logical processing of that message can take longer.

SPAN_KIND_CONSUMER

The span describes a consumer receiving a message from a broker.

Export Results

These constants are used to distinguish the result of an export operation. They can be imported individually, or with the export tag.

EXPORT_RESULT_SUCCESS

Marks an export operation as a success.

EXPORT_RESULT_FAILURE

Marks an export operation as a failure.

EXPORT_RESULT_TIMEOUT

Marks an export operation that was interrupted because it took too long.

Trace Export Results

These constants are the sames as those described in the section above, but were defined when they were only expected to be used for the export of traces. They are kept for backwards compatibility, and because these names continue to be used by the OpenTelemetry specifiction.

They can be imported individually, or with the trace_export tag. They are also imported when using the trace tag.

TRACE_EXPORT_SUCCESS

Marks an export operation as a success. A synomym for "EXPORT_RESULT_SUCCESS".

TRACE_EXPORT_FAILURE

Marks an export operation as a failure. A synomym for "EXPORT_RESULT_FAILURE".

TRACE_EXPORT_TIMEOUT

Marks an export operation that was interrupted because it took too long. A synomym for "EXPORT_RESULT_TIMEOUT".

Log Severity Values

These constants are used to identify the severity of different log record objects. They can be imported individually, or with the log tag. They are dualvar scalars, with a numeric value and a string value suitable to be used when displaying to a human-readable location.

LOG_LEVEL_TRACE

Equivalent to 1 when used as a number, and TRACE when used as a string.

LOG_LEVEL_TRACE2

Equivalent to 2 when used as a number, and TRACE2 when used as a string.

LOG_LEVEL_TRACE3

Equivalent to 3 when used as a number, and TRACE3 when used as a string.

LOG_LEVEL_TRACE4

Equivalent to 4 when used as a number, and TRACE4 when used as a string.

LOG_LEVEL_DEBUG

Equivalent to 5 when used as a number, and DEBUG when used as a string.

LOG_LEVEL_DEBUG2

Equivalent to 6 when used as a number, and DEBUG2 when used as a string.

LOG_LEVEL_DEBUG3

Equivalent to 7 when used as a number, and DEBUG3 when used as a string.

LOG_LEVEL_DEBUG4

Equivalent to 8 when used as a number, and DEBUG4 when used as a string.

LOG_LEVEL_INFO

Equivalent to 9 when used as a number, and INFO when used as a string.

LOG_LEVEL_INFO2

Equivalent to 10 when used as a number, and INFO2 when used as a string.

LOG_LEVEL_INFO3

Equivalent to 11 when used as a number, and INFO3 when used as a string.

LOG_LEVEL_INFO4

Equivalent to 12 when used as a number, and INFO4 when used as a string.

LOG_LEVEL_WARN

Equivalent to 13 when used as a number, and WARN when used as a string.

LOG_LEVEL_WARN2

Equivalent to 14 when used as a number, and WARN2 when used as a string.

LOG_LEVEL_WARN3

Equivalent to 15 when used as a number, and WARN3 when used as a string.

LOG_LEVEL_WARN4

Equivalent to 16 when used as a number, and WARN4 when used as a string.

LOG_LEVEL_ERROR

Equivalent to 17 when used as a number, and ERROR when used as a string.

LOG_LEVEL_ERROR2

Equivalent to 18 when used as a number, and ERROR2 when used as a string.

LOG_LEVEL_ERROR3

Equivalent to 19 when used as a number, and ERROR3 when used as a string.

LOG_LEVEL_ERROR4

Equivalent to 20 when used as a number, and ERROR4 when used as a string.

LOG_LEVEL_FATAL

Equivalent to 21 when used as a number, and FATAL when used as a string.

LOG_LEVEL_FATAL2

Equivalent to 22 when used as a number, and FATAL2 when used as a string.

LOG_LEVEL_FATAL3

Equivalent to 23 when used as a number, and FATAL3 when used as a string.

LOG_LEVEL_FATAL4

Equivalent to 24 when used as a number, and FATAL4 when used as a string.

Placeholder Invalid IDs

These constants are used as global null values for span and trace IDs. They can be imported individually.

INVALID_SPAN_ID

Returns a constant ID that can be used to identify an invalid span in bytes. This is also imported when using the span tag.

INVALID_TRACE_ID

Returns a constant ID that can be used to identify an invalid trace in bytes. This is also imported when using the trace tag.

HEX_INVALID_SPAN_ID

Returns a constant ID that can be used to identify an invalid span as a hexadecimal string in lowercase. This is also imported when using the span tag.

HEX_INVALID_TRACE_ID

Returns a constant ID that can be used to identify an invalid trace as a hexadecimal string in lowercase. This is also imported when using the trace tag.

COPYRIGHT AND LICENSE

This software is copyright (c) 2023 by José Joaquín Atria.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.