Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jjatria/perl-opentelemetry
A Perl implementation of the OpenTelemetry standard
https://github.com/jjatria/perl-opentelemetry
opentelemetry perl
Last synced: 7 days ago
JSON representation
A Perl implementation of the OpenTelemetry standard
- Host: GitHub
- URL: https://github.com/jjatria/perl-opentelemetry
- Owner: jjatria
- License: other
- Created: 2022-11-13T15:36:23.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-20T12:51:45.000Z (26 days ago)
- Last Synced: 2024-10-31T21:42:45.419Z (14 days ago)
- Topics: opentelemetry, perl
- Language: Perl
- Homepage: https://metacpan.org/pod/OpenTelemetry
- Size: 433 KB
- Stars: 23
- Watchers: 4
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: Changes
- License: LICENSE
Awesome Lists containing this project
README
# OpenTelemetry for Perl
[![Coverage Status]][coveralls]
This is part of an ongoing attempt at implementing the OpenTelemetry
standard in Perl. The distribution in this repository implements the
abstract OpenTelemetry API, with [an SDK implementation] being worked on
separately.
## What is OpenTelemetry?
OpenTelemetry is an open source observability framework, providing a
general-purpose API, SDK, and related tools required for the instrumentation
of cloud-native software, frameworks, and libraries.
OpenTelemetry provides a single set of APIs, libraries, agents, and collector
services to capture distributed traces and metrics from your application. You
can analyze them using Prometheus, Jaeger, and other observability tools.
## How does this distribution fit in?
This distribution defines the core OpenTelemetry interfaces in the form of
abstract classes and no-op implementations. That is, it defines interfaces and
data types sufficient for a library or application to code against to produce
telemetry data, but does not actually collect, analyze, or export the data.
To collect and analyze telemetry data, *applications* should also install a
concrete implementation of the API. None exists at the moment, but work on
this should start next.
This separation allows *libraries* that produce telemetry data to depend only
on the API, deferring the choice of concrete implementation to the application
developer.
## How do I get started?
Install this distribution from CPAN:
```
cpanm OpenTelemetry
```
or directly from the repository if you want to install a development
version (although note that only the CPAN version is recommended for
production environments):
```
# On a local fork
cd path/to/this/repo
cpanm install .
# Over the net
cpanm https://github.com/jjatria/perl-opentelemetry.git
```
Then, use the OpenTelemetry interfaces to produces traces and other telemetry
data. Following is a basic example (although bear in mind this interface is
still being drafted, so some details might change):
``` perl
use OpenTelemetry;
use v5.36;
# Obtain the current default tracer provider
my $provider = OpenTelemetry->tracer_provider;
# Create a trace
my $tracer = $provider->tracer( name => 'my_app', version => '1.0' );
# Record spans
$tracer->in_span( outer => sub ( $span, $context ) {
# In outer span
$tracer->in_span( inner => sub ( $span, $context ) {
# In inner span
});
});
```
## How can I get involved?
We are in the process of setting up an OpenTelemetry-Perl special interest
group (SIG). Until that is set up, you are free to [express your
interest][sig] or join us in IRC on the #io-async channel in irc.perl.org.
## License
The OpenTelemetry distribution is licensed under the same terms as Perl
itself. See [LICENSE] for more information.
[an SDK implementation]: https://github.com/jjatria/perl-opentelemetry-sdk
[Coverage Status]: https://coveralls.io/repos/github/jjatria/perl-opentelemetry/badge.svg?branch=main
[coveralls]: https://coveralls.io/github/jjatria/perl-opentelemetry?branch=main
[license]: https://github.com/jjatria/perl-opentelemetry/blob/main/LICENSE
[sig]: https://github.com/open-telemetry/community/issues/828