DogStatsD module provides a simple way to send events and metrics or other messages to DataDog from PowerShell via DogStatsD UDP protocol.
DogStatsD is available via PowerShellGallery, so you can simply install it with the following command:
Install-Module DogStatsD
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")
# Send a Gauge metric with value from variable to a given host and port
Send-DataDogMetric -Type Gauge -Name 'random.value' -Value $randomvalue -ComputerName 192.168.0.1 -Port 8125
# Send lots of Counter metric values via the pipeline
1..20000 | Send-DataDogMetric -Type Counter -Name 'incrementing.value' -Value { $_ }
# Use the output of another command to provide values for a Gauge metric
Get-AppStatistics | Send-DataDogMetric -Type Gauge -Name 'appco.active_users' -Value { $_.ActiveUsers }
# Use input objects to generate tags and values for a Counter metric
Get-Process |
Send-DataDogMetric -Name 'process.handles' -Type Counter -Value { $_.Handles } -Tag { @("process:$($_.ProcessName)","pid:$($_.Id)") }
Cmdlets and functions for DogStatsD have their own help PowerShell help, which
you can read with help <cmdlet-name>
.
DogStatsD aims to adhere to Semantic Versioning 2.0.0.
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.
- 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:
- Fork the repo
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request
Created and maintained by Akos Murati ([email protected])
Apache License, Version 2.0 (see LICENSE)