Flare Flare Laravel Laravel PHP PHP JavaScript JavaScript Protocol Protocol

Resources

A resource represents the entity producing telemetry data (your application/service). Resource attributes are shared across all spans and events within the same resource.

In the traces endpoint, the resource is a nested object with its own attributes. In the errors endpoint, resource attributes are merged into the flat attributes object on the root payload.

Scope

A scope represents the instrumentation library that produced the spans. Different libraries (e.g. your Flare client, a database recorder, a cache recorder) can each be their own scope within the same resource.

In the traces endpoint, the scope is a nested object with its own attributes. In the errors endpoint, scope attributes are merged into the flat attributes object on the root payload.

Attributes

Service

Attribute Type Description
service.name string Application/service name
service.version string Application version
service.stage string Environment (e.g. production, staging)

Telemetry SDK

Attribute Type Description
telemetry.sdk.language string SDK language (e.g. PHP, JavaScript)
telemetry.sdk.name string SDK name (e.g. flare-client)
telemetry.sdk.version string SDK version

Flare

Attribute Type Description
flare.language.name string Language name (e.g. PHP, JavaScript)
flare.language.version string Language version
flare.framework.name string Framework name (e.g. Laravel)
flare.framework.version string Framework version

Host

Attribute Type Description
host.name string Hostname
host.ip string Host IP address
host.arch string Architecture (e.g. arm64, x86_64)

OS

Attribute Type Description
os.type string OS type (e.g. darwin, linux, windows)
os.name string OS name (e.g. macOS, Ubuntu)
os.version string OS version
os.description string OS description

Process

Attribute Type Description
process.pid int Process ID
process.executable.path string Executable path
process.command string Command name
process.command_args array Command arguments
process.command_line string Full command line
process.exit_code int/null Exit code
process.owner string Process owner
process.runtime.name string Runtime name (e.g. PHP (cli))
process.runtime.version string Runtime version

Git

Attribute Type Description
git.hash string Commit hash
git.message string Commit message
git.branch string Branch name
git.tag string Tag name
git.remote string Remote URL
git.is_dirty bool Whether working tree has uncommitted changes

User

Attribute Type Description
user.id string User ID
user.full_name string User full name
user.email string User email
user.attributes object Additional user attributes

Context

Attribute Type Description
context.custom object Custom context data

Laravel

Attribute Type Description
laravel.locale string Application locale
laravel.config_cached bool Whether config is cached
laravel.debug bool Whether debug mode is enabled
context.laravel object Laravel-specific context
Introduction Events