muratiakos / DogStatsD

Simple PowerShell module to send events and metrics to DataDog via DogStatsD

DogStatsD PowerShell module

DogStatsD module provides a simple way to send events and metrics or other messages to DataDog from PowerShell via DogStatsD UDP protocol.

Installation

DogStatsD is available via PowerShellGallery and via PsGet, so you can simply install it with the following command:

Install-Module DogStatsD

Usage and some example

Import-Module DogStatsD

# Send Datadog Info Events
Send-DataDogEvent -Title "Test Event" -Text 'This is a detail text for a info event'

# Send Datadog Error Events
Send-DataDogEvent -Title "Failure Event" -Text 'Error details can come here' -AlertType error

# Send a Histogram metric for an example command duration
Send-DataDogMetric -Type Histogram -Name 'command.duration' -Value 12 -Tag @("command:my_command_name")

Documentation

Cmdlets and functions for DogStatsD have their own help PowerShell help, which you can read with help <cmdlet-name>.

Versioning

DogStatsD aims to adhere to Semantic Versioning 2.0.0.

Issues

In case of any issues, raise an issue ticket in this repository and/or feel free to contribute to this project if you have a possible fix for it.

Development

• Source hosted at Github.com
• Report issues/questions/feature requests on Github Issues

Pull requests are very welcome! Make sure your patches are well tested. Ideally create a topic branch for every separate change you make. For example:

1. Fork the repo
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Added some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request

Authors

Created and maintained by Akos Murati ([e-mail])

License

Apache License, Version 2.0 (see LICENSE)