OpenTracing::Manual - A quick overview about Perl5 and OpenTracing
The OpenTracing module on CPAN is NOT COMPLIANT with anything remotely like OpenTracing.IO or the OpenTracing::Interface.
OpenTracing
DO NOT USE THE OPENTRACING PACKAGE
This Manual is a quick overview of what is available in Perl related to the OpenTracing API Interface Definition.
This manual targets three different audiences:
Those that want to add instrumentation and tracing to their application or microservices.
See OpenTracing::Manual::Instrumentation.
Those writing integrations for frameworks, in order to easily extract tracing information from incoming requests or inject tracing into outgoing requests.
See OpenTracing::Manual::Integration.
Those that want to have the Perl implementation communicate with their tracing service provider.
See OpenTracing::Manual::Implementation.
From the OpenTracing IO website:
OpenTracing is comprised of an API specification, frameworks and libraries that have implemented the specification, and documentation for the project. OpenTracing allows developers to add instrumentation to their application code using APIs that do not lock them into any one particular product or vendor.
Distributed tracing, also called distributed request tracing, is a method used to profile and monitor applications, especially those built using a microservices architecture. Distributed tracing helps pinpoint where failures occur and what causes poor performance.
See also: OpenTracing Overview.
For a very condensed overview of how to use OpenTracing see: "SYNOPSIS" in OpenTracing::Interface
Included is a list of available Perl Modules and those that are on the horizon. For more, see the OpenTracing::Manual::Ecosystem.
The specification itself, and related modules.
Distributed tracing is all about connecting services and microservices together. These modules will handle the edges of the application and services and bootstrap tracer implementations.
Once an application is running and the framework has taken care of most of the bootstrapping, these modules help to manage more detailed spans.
A list of various implementations that are compliant with the OpenTracing API.
Modules that might be of interest when developing integrations or implementations.
These modules will be needed for easier instrumentation of an application or better framework integration and distributed tracing.
Since all the work has been done for Perceptyx, no further development will be done on the following, unless ...
A role that defines the Tracer interface.
For Application Developers and Devops.
For Framework or Integration Developers
For Tracing Service Implementations
An overview of the OpenTracing puzzle pieces.
The OpenTracing API standard.
Theo van Hoesel <tvanhoesel@perceptyx.com>
'OpenTracing API for Perl' is Copyright (C) 2019 .. 2020, 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 library 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.
To install OpenTracing::Manual, copy and paste the appropriate command in to your terminal.
cpanm
cpanm OpenTracing::Manual
CPAN shell
perl -MCPAN -e shell install OpenTracing::Manual
For more information on module installation, please visit the detailed CPAN module installation guide.