Download the PHP package datadog/php-datadogstatsd without Composer
On this page you can find all versions of the php package datadog/php-datadogstatsd. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download datadog/php-datadogstatsd
More information about datadog/php-datadogstatsd
Files in datadog/php-datadogstatsd
Package php-datadogstatsd
Short Description An extremely simple PHP datadogstatsd client
License MIT
Homepage https://www.datadoghq.com/
Informations about the package php-datadogstatsd
PHP DataDog StatsD Client
This is an extremely simple PHP DogStatsD client.
Requires PHP >= 5.6.0.
See CHANGELOG.md for changes.
For a Laravel-specific implementation that wraps this library, check out laravel-datadog-helper.
Installation
Add the following to your composer.json
:
The first version shipped in composer is 0.0.3
Or manually clone this repository and set it up with require './src/DogStatsd.php'.
Once installed, turn on the socket extension to PHP which must be enabled at compile time by giving the --enable-sockets
option to configure.
Configuration
To instantiate a DogStatsd object using composer
:
DogStatsd constructor, takes a configuration array. See the full list of available DogStatsD Client instantiation parameters.
Origin detection over UDP in Kubernetes
Origin detection is a method to detect which pod DogStatsD packets are coming from in order to add the pod's tags to the tag list.
To enable origin detection over UDP, add the following lines to your application manifest
The DogStatsD client attaches an internal tag, entity_id
. The value of this tag is the content of the DD_ENTITY_ID
environment variable, which is the pod’s UID.
The agent uses this tag to infer packets' origin, and tag their metrics accordingly.
Usage
In order to use DogStatsD metrics, events, and Service Checks the Agent must be running and available.
Metrics
After the client is created, you can start sending custom metrics to Datadog. See the dedicated Metric Submission: DogStatsD documentation to see how to submit all supported metric types to Datadog with working code examples:
- Submit a COUNT metric.
- Submit a GAUGE metric.
- Submit a SET metric
- Submit a HISTOGRAM metric
- Submit a TIMER metric
- Submit a DISTRIBUTION metric
Some options are suppported when submitting metrics, like applying a Sample Rate to your metrics or tagging your metrics with your custom tags.
Events
After the client is created, you can start sending events to your Datadog Event Stream. See the dedicated Event Submission: DogStatsD documentation to see how to submit an event to your Datadog Event Stream.
Service Checks
After the client is created, you can start sending Service Checks to Datadog. See the dedicated Service Check Submission: DogStatsD documentation to see how to submit a Service Check to Datadog.
Roadmap
- Write unit tests
- Document service check functionality
Tests
Lint
Fix lint
All versions of php-datadogstatsd with dependencies
ext-sockets Version *