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>