Metrics::Any::Adapter

Section: User Contributed Perl Documentation (3pm)
Updated: 2022-12-30
Index Return to Main Contents
 

NAME

"Metrics::Any::Adapter" - set the "Metrics::Any" adapter for the program  

SYNOPSIS

In a program or top-level program-like module:

   use Metrics::Any::Adapter 'Prometheus';

 

DESCRIPTION

The "use" statement which loads this module sets the adapter module for Metrics::Any to report metrics generated by an modules the program uses.

The first value passed should be a string giving the name of an adapter module, which will be expected under the "Metrics::Any::Adapter::"-prefix. This module will be loaded and set as the adapter to use. Any additional arguments will be passed to the constructor of the adapter instance.

   use Metrics::Any::Adapter Custom => "another arg";

   # implies
   $adapter = Metrics::Any::Adapter::Custom->new( "another arg" );

 

ENVIRONMENT

 

METRICS_ANY_ADAPTER

Since version 0.04.

Sets the default adapter type to use if the program has not otherwise requested one.

Normally this is set to "Null", which loads Metrics::Any::Adapter::Null. By overriding this to a different value, a default adapter can be loaded without modifying the program. This may be useful for example, when running unit tests:

   $ METRICS_ANY_ADAPTER=Stderr ./Build test

Additional arguments can be specified after a colon, separated by commas or equals signs.

   $ METRICS_ANY_ADAPTER=File:path=metrics.log ./program.pl

Note that if a program requests a specific adapter that will override this variable.

A limited attempt is made at supporting nested arguments wrapped in square brackets, to allow basic operation of the Metrics::Any::Adapter::Tee adapter via this variable to itself pass arguments into child adapters:

   $ METRICS_ANY_ADAPTER=Tee:Prometheus,[File:path=metrics.log] perl ...

This should be considered a best-effort scenario useful for short-term testing and debugging. For more complex requirements in your script or program, it is better to use the import arguments directly as then any perl data structures can be passed around.  

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>


 

Index

NAME
SYNOPSIS
DESCRIPTION
ENVIRONMENT
METRICS_ANY_ADAPTER
AUTHOR

This document was created by man2html, using the manual pages.
Time: 00:09:08 GMT, May 23, 2024