Flow PHP

trace_id()

Create a TraceId.

Parameters

$hex : null|string = null

Optional 32-character hexadecimal string

Tags

throws

InvalidArgumentException

if the hex string is invalid

span_id()

Create a SpanId.

Parameters

$hex : null|string = null

Optional 16-character hexadecimal string

Tags

throws

InvalidArgumentException

if the hex string is invalid

baggage()

Create a Baggage.

Parameters

$entries : array<string, string> = []

Initial key-value entries

context()

Create a Context.

Parameters

$traceId : null|TraceId = null

Optional TraceId to use

$baggage : null|Baggage = null

Optional Baggage to use

memory_context_storage()

Create a MemoryContextStorage.

Parameters

$context : null|Context = null

Optional initial context

resource()

Create a Resource.

Parameters

$attributes : array<string, array<string|int, bool|float|int|string>|bool|float|int|string>|Attributes = []

Resource attributes

span_context()

Create a SpanContext.

Parameters

$traceId : TraceId

The trace ID

$spanId : SpanId

The span ID

$parentSpanId : null|SpanId = null

Optional parent span ID

span_event()

Create a SpanEvent (GenericEvent) with an explicit timestamp.

Parameters

$name : string

Event name

$timestamp : DateTimeImmutable

Event timestamp

$attributes : array<string, array<string|int, bool|float|int|string>|bool|float|int|string>|Attributes = []

Event attributes

span_link()

Create a SpanLink.

Parameters

$context : SpanContext

The linked span context

$attributes : array<string, array<string|int, bool|float|int|string>|bool|float|int|string>|Attributes = []

Link attributes

span_limits()

Create SpanLimits configuration.

Parameters

$attributeCountLimit : int = 128

Maximum number of attributes per span

$eventCountLimit : int = 128

Maximum number of events per span

$linkCountLimit : int = 128

Maximum number of links per span

$attributePerEventCountLimit : int = 128

Maximum number of attributes per event

$attributePerLinkCountLimit : int = 128

Maximum number of attributes per link

$attributeValueLengthLimit : null|int = null

Maximum length for string attribute values (null = unlimited)

log_record_limits()

Create LogRecordLimits configuration.

Parameters

$attributeCountLimit : int = 128

Maximum number of attributes per log record

$attributeValueLengthLimit : null|int = null

Maximum length for string attribute values (null = unlimited)

metric_limits()

Create MetricLimits configuration.

Parameters

$cardinalityLimit : int = 2000

Maximum number of unique attribute combinations per instrument

void_span_processor()

Create a VoidSpanProcessor.

void_metric_processor()

Create a VoidMetricProcessor.

void_log_processor()

Create a VoidLogProcessor.

void_exporter()

Create a VoidExporter.

memory_exporter()

Create a MemoryExporter.

memory_span_processor()

Create a MemorySpanProcessor.

Parameters

$exporter : Exporter

The exporter to send spans to

$errorHandler : ErrorHandler = new ErrorLogHandler()

Handler for Throwables raised by the exporter

memory_metric_processor()

Create a MemoryMetricProcessor.

Parameters

$exporter : Exporter

The exporter to send metrics to

$errorHandler : ErrorHandler = new ErrorLogHandler()

Handler for Throwables raised by the exporter

memory_log_processor()

Create a MemoryLogProcessor.

Parameters

$exporter : Exporter

The exporter to send logs to

$errorHandler : ErrorHandler = new ErrorLogHandler()

Handler for Throwables raised by the exporter

tracer_provider()

Create a TracerProvider.

Parameters

$processor : SpanProcessor

The processor for spans

$clock : ClockInterface

The clock for timestamps

$contextStorage : ContextStorage

Storage for context propagation

$sampler : Sampler = new AlwaysOnSampler()

Sampling strategy for spans

$limits : SpanLimits = new SpanLimits()

Limits for span attributes, events, and links

$errorHandler : ErrorHandler = new ErrorLogHandler()

Handler for runtime Throwables raised by the processor

logger_provider()

Create a LoggerProvider.

Parameters

$processor : LogProcessor

The processor for logs

$clock : ClockInterface

The clock for timestamps

$contextStorage : ContextStorage

Storage for span correlation

$limits : LogRecordLimits = new LogRecordLimits()

Limits for log record attributes

$errorHandler : ErrorHandler = new ErrorLogHandler()

Handler for runtime Throwables raised by the processor

meter_provider()

Create a MeterProvider.

Parameters

$processor : MetricProcessor

The processor for metrics

$clock : ClockInterface

The clock for timestamps

$temporality : AggregationTemporality = AggregationTemporality::CUMULATIVE

Aggregation temporality for metrics

$exemplarFilter : ExemplarFilter = new TraceBasedExemplarFilter()

Filter for exemplar sampling (default: TraceBasedExemplarFilter)

$limits : MetricLimits = new MetricLimits()

Cardinality limits for metric instruments

$errorHandler : ErrorHandler = new ErrorLogHandler()

Handler for runtime Throwables raised by the processor

telemetry()

Create a new Telemetry instance with the given providers.

Parameters

$resource : Resource

The resource describing the entity producing telemetry

$tracerProvider : null|TracerProvider = null

The tracer provider (null for void/disabled)

$meterProvider : null|MeterProvider = null

The meter provider (null for void/disabled)

$loggerProvider : null|LoggerProvider = null

The logger provider (null for void/disabled)

$errorHandler : ErrorHandler = new ErrorLogHandler()

Handler propagated to default void providers when explicit ones are not supplied

instrumentation_scope()

Create an InstrumentationScope.

Parameters

$name : string

The instrumentation scope name

$version : string = 'unknown'

The instrumentation scope version

$schemaUrl : null|string = null

Optional schema URL

$attributes : Attributes = new Attributes()

batching_span_processor()

Create a BatchingSpanProcessor.

Parameters

$exporter : Exporter

The exporter to send spans to

$batchSize : int = 512

Number of spans to collect before exporting (default 512)

$errorHandler : ErrorHandler = new ErrorLogHandler()

Handler for Throwables raised by the exporter

pass_through_span_processor()

Create a PassThroughSpanProcessor.

Parameters

$exporter : Exporter

The exporter to send spans to

$errorHandler : ErrorHandler = new ErrorLogHandler()

Handler for Throwables raised by the exporter

batching_metric_processor()

Create a BatchingMetricProcessor.

Parameters

$exporter : Exporter

The exporter to send metrics to

$batchSize : int = 512

Number of metrics to collect before exporting (default 512)

$errorHandler : ErrorHandler = new ErrorLogHandler()

Handler for Throwables raised by the exporter

pass_through_metric_processor()

Create a PassThroughMetricProcessor.

Parameters

$exporter : Exporter

The exporter to send metrics to

$errorHandler : ErrorHandler = new ErrorLogHandler()

Handler for Throwables raised by the exporter

batching_log_processor()

Create a BatchingLogProcessor.

Parameters

$exporter : Exporter

The exporter to send logs to

$batchSize : int = 512

Number of logs to collect before exporting (default 512)

$errorHandler : ErrorHandler = new ErrorLogHandler()

Handler for Throwables raised by the exporter

pass_through_log_processor()

Create a PassThroughLogProcessor.

Parameters

$exporter : Exporter

The exporter to send logs to

$errorHandler : ErrorHandler = new ErrorLogHandler()

Handler for Throwables raised by the exporter

severity_filtering_log_processor()

Create a SeverityFilteringLogProcessor.

Parameters

$processor : LogProcessor

The processor to wrap

$minimumSeverity : Severity = Severity::INFO

Minimum severity level (default: INFO)

console_exporter()

Create a unified ConsoleExporter for logs, metrics, and spans.

Parameters

$colors : bool = true

Whether to use ANSI colors (default: true)

$maxLogBodyLength : null|int = 100

Maximum length for log body+attributes column (null = no limit)

$logOptions : ConsoleLogOptions = new ConsoleLogOptions()

Display options for log records

$metricOptions : ConsoleMetricOptions = new ConsoleMetricOptions()

Display options for metrics

$spanOptions : ConsoleSpanOptions = new ConsoleSpanOptions()

Display options for spans

console_span_options()

Create ConsoleSpanOptions with all display options enabled (default behavior).

console_span_options_minimal()

Create ConsoleSpanOptions with minimal display (legacy compact format).

console_log_options()

Create ConsoleLogOptions with all display options enabled (default behavior).

console_log_options_minimal()

Create ConsoleLogOptions with minimal display (legacy compact format).

console_metric_options()

Create ConsoleMetricOptions with all display options enabled (default behavior).

console_metric_options_minimal()

Create ConsoleMetricOptions with minimal display (legacy compact format).

always_on_exemplar_filter()

Create an AlwaysOnExemplarFilter.

always_off_exemplar_filter()

Create an AlwaysOffExemplarFilter.

trace_based_exemplar_filter()

Create a TraceBasedExemplarFilter.

propagation_context()

Create a PropagationContext.

Parameters

$spanContext : null|SpanContext = null

Optional span context

$baggage : null|Baggage = null

Optional baggage

array_carrier()

Create an ArrayCarrier.

Parameters

$data : array<string, string> = []

Initial carrier data

superglobal_carrier()

Create a SuperglobalCarrier.

w3c_trace_context()

Create a W3CTraceContext propagator.

w3c_baggage()

Create a W3CBaggage propagator.

composite_propagator()

Create a CompositePropagator.

Parameters

$propagators : Propagator

The propagators to combine

chain_detector()

Create a ChainDetector.

Parameters

$detectors : ResourceDetector

The detectors to chain

os_detector()

Create an OsDetector.

host_detector()

Create a HostDetector.

process_detector()

Create a ProcessDetector.

environment_detector()

Create an EnvironmentDetector.

composer_detector()

Create a ComposerDetector.

manual_detector()

Create a ManualDetector.

Parameters

$attributes : array<string, array<string|int, bool|float|int|string>|bool|float|int|string>

Resource attributes

caching_detector()

Create a CachingDetector.

Parameters

$detector : ResourceDetector

The detector to wrap

$cachePath : null|string = null

Cache file path (default: sys_get_temp_dir()/flow_telemetry_resource.cache)

resource_detector()

Create a resource detector chain.

Parameters

$detectors : array<string|int, ResourceDetector> = []

Optional custom detectors (empty = use defaults)

error_log_handler()

Create the default ErrorLogHandler. Writes via PHP's error_log().

Parameters

$messageType : ErrorLogMessageType = ErrorLogMessageType::OperatingSystem

$expandNewlines : bool = false

$messagePrefix : string = '[flow-telemetry]'

stream_error_handler()

Create a StreamHandler. Appends formatted Throwables (one per line) to a file path or php:// stream wrapper.

Parameters

$destination : string

$filePermissions : int = 0644

$createDirectories : bool = true

$messagePrefix : string = '[flow-telemetry]'

syslog_error_handler()

Create a SyslogHandler. Writes via openlog/syslog/closelog.

Parameters

$ident : string = 'flow-telemetry'

$facility : SyslogFacility = SyslogFacility::User

$logOpts : int = LOG_PID

$severity : SyslogSeverity = SyslogSeverity::Error

udp_syslog_error_handler()

Create a UdpSyslogHandler. Sends RFC 5424-style syslog frames over UDP.

Parameters

$host : string

$port : int = 514

$ident : string = 'flow-telemetry'

$facility : SyslogFacility = SyslogFacility::User

$severity : SyslogSeverity = SyslogSeverity::Error

composite_error_handler()

Fan errors out to multiple handlers.

Parameters

$handlers : ErrorHandler

null_error_handler()

Discard every error. Use only in tests or for explicit silence.