The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

OpenTracing::Implementation::DataDog - Sending traces to DataDog using Agent

VERSION

This is version 'v0.43.1'

WARNING

This version is for

OpenTracing::Interface version v0.204.x
OpenTracing::Role vesion v0.81.2

SYNOPSIS

    use alias "OpenTracing::Implementation::DataDog", 'Implementation';
    
    my $tracer = Implementation->bootstrap_tracer(
        agent => {
            host            => 'localhost',
            port            => '8126',
            path            => 'v0.3/traces',
        },
        default_context => {
            service_name    => 'MyService',
            service_type    => 'web',
            resource_name   => 'my_cgi_endpoint',
        },
    );

DESCRIPTION

This `DataDog` implementation for 'OpenTracing' is fully compliant with the open source definition of OpenTracing::Interface.

This implementation connects to the localhost installed agent by default, that listens to port 8126. It recieves traces at the /v0.3/traces endpoint.

CLASS METHODS

bootstrap_tracer

    my $tracer = OpenTracing::Implementation::DataDog->bootstrap_tracer( );

Returns a OpenTracing::Interface::Tracer compliant tracer, using the OpenTracing::Implementation::NoOp::Tracer implementation.

named paramters

agent

A hasreference with instantiation options for OpenTracing::Implementation::DataDog::Client.

default_context

A hasreference with instantiation options for OpenTracing::Implementation::DataDog::SpanContext. This will be used if no context can be found for <$tracer-extract_context>>.

ENVIRONMENT VARIABLES

STRICT

STRICT on itself not a environment variable, but a boolean constant from Devel::StrictMode that uses the following set of environment variables:

PERL_STRICT
EXTENDED_TESTING
AUTHOR_TESTING
RELEASE_TESTING

When any of those are set, tests are run using type constraints and parameter checks are performed, as well as return objects or values. During production it is recommended to keep these switched off for performance improvements.

AUTHOR

Theo van Hoesel <tvanhoesel@perceptyx.com>

COPYRIGHT AND LICENSE

'OpenTracing::Implementation::DataDog' is Copyright (C) 2019 .. 2021, Perceptyx Inc

This library is free software; you can redistribute it and/or modify it under the terms of the Artistic License 2.0.

This package is distributed in the hope that it will be useful, but it is provided "as is" and without any express or implied warranties.

For details, see the full text of the license in the file LICENSE.