Skip to content

Latest commit

 

History

History
87 lines (79 loc) · 20.6 KB

README.md

File metadata and controls

87 lines (79 loc) · 20.6 KB

Miscellany

Intended to be a repository for miscellaneous scripts and tools from Datadog to be shared with the public.

Disclaimer

These projects are not a part of Datadog's subscription services and are provided for example purposes only. They are NOT guaranteed to be bug free and are not production quality. If you choose to use to adapt them for use in a production environment, you do so at your own risk.

Contributing

When adding a new script/tool, be sure to do the following:

  • Open a PR for review
  • Add a link and description to one of the tables above

We encourage creating a subfolder with a separate README that gives more details on the script/tool.

Scripts & Tools

These scripts and tools live in this repo, some scripts/tools have their own README in their subfolder with further explaintation and usage.

Name Language Function
count_hosts_by_tag Python This script will return the number of hosts with a given tag applied. If the tag is only the key of a key:value pair, all related values will be counted.
mute_monitors_with_tags Python This script mutes all monitors that are tagged with a set of monitor tags
linux_odfs_API Bash Script to capture linux open file descriptor metrics
query_freshness Python Report the "freshness" (how long ago a metric was submitted) of a metric. See this KB for more info
custom_check_shell Python/Bash Spins up a VM using vagrant that installs the Datadog agent on it with a simple custom check using shell
empty_dash Python Creates an empty dashboard for test purposes
get_all_boards Python Gets all boards for a given organization and print out their json. Useful for malformed boards created via the API
Remove old dashboards & monitors Python Will remove all old dashboards and monitors from an account belonging to the email as specified in the script's parameter.
get_hostname_agentversion Python Gets the version of the agent running for each host
s3_permissions Python Checks S3 bucket ACL permissions for read/write access and reports a metric to Datadog
uptime Python Custom check to track uptime. At the time that this check was written, it wasn't possible to view a monitor's uptime on a dashboard or via the API, or to view uptime with multiple decimals of precision, but please check if those features are available before using this check.
api_limits_as_custom_metrics Python Gets the Datadog API rate limits from the Datadog API and submits them as metrics
cross-org-metric-broker Python Takes metrics from one account (org) and posts them to another account (org)
csvmod Python Example script of grabbing a timeseries and dumping to a CSV
dashconverter Python Convert from screenboard to timeboard and vice versa
metric_usage_report Python Enter a list of metrics, and receive a report showing where the metrics are used in your account
dd_public_ip Bash Script to run from an AWS instance that will add a tag for the public ip
fullmetrics_dash Python Creates a dashboard for a given integration with all metrics being reported through that integration
hosts_with_aws_without_agent Python List of ec2 instances without the datadog-agent installed
merge_screenboards Python Takes two screenboards and combines them into one
migrate_dashboard Python Migrate a screenboard from one account (or org) to another
migrate_monitors Python Migrate monitors by query from one account (or org) to another
dash_to_json Python Convert Dashboard to JSON and Create Dashboard from JSON
import_screenboard Python Creates a new screenboard from json
export_screenboard Python Exports a single screenboard to a json file
base_scripts Python A collection of generic scripts that can be used as a starting point for creating your own custom scripts
remove_lingering_aws_host_tags Python This is a tool for removing AWS host-level tags from your infrastructure in Datadog. It is intended for users who have removed their EC2 instances from their AWS integration and if they no longer want to see AWS tags associated with the hosts that still run datadog-agents.
remove_single_tag_tmp Python Removes a single tag from a host
update_multiple_monitors_example Python example of how to update multiple monitors at once
create_monitor Python simple example of creating metric query monitor with thresholds
weatherExample Python Example script that submits the temperature and wind speed from the Wunderground API to Datadog as metrics
sql_redacted Python Submits a metric based on a SQL query
multi_org_create_users Python Creates multiple Datadog users across multiple Datadog Orgs
create_monitor_terraform Terraform Creates a monitor using Terraform
query hosts and create tags Python queries hosts api using pagination and creates new tags
get all groups in a monitor Python queries for all groups in a monitor and outputs a list of them
create a csv file with a list of log in handles Python creates a CSV file in the same directory as the script containing a list of all user log in handles
Powershell script to call JSON REST endpoint, pass those key-value pairs to DogstatsD Powershell A Powershell script which will call a given HTTP GET endpoint, and then submit the key-value pairs found in the resulting JSON body to DogsStatsD. Resource endpoint must be a non-nested JSON body ({"a":"1","b":"2"} -> custom metrics: a|1, b|2
Dogmover Python Migrate screenboards, timeboards and monitors from one organization to another (supports migrations between US>EU instances.)
Update Host Tags with Host Metadata (example) Python Queries the host API then creates tags based off of the gohai (or other) metadata.
Historic usage to CSV Python This script is meant to pull historical usage metrics and export them to CSV.
dd_aws_add_account.py Python script for creating aws integration
Send_filesystem_events Python This script uses inotify to send an event to the event stream when it detects a change in files or folders in a given directory.
create_users_and_emails_list.py Python script to get a list of user emails as csv
DD User Report (JSON) Python Generates various different user reports and pretty prints the json for further processing -- useful for large orgs with 100s or 1000s or users
Get All Public Dashboards Python Gets a full list (returned as JSON) of all dashboards that are public for a given organization
Get All Child Orgs Python Gets a full list (returned as JSON) of all child organizations for a given organization
PySNMP-MIB-Parser Python Converts a MIB file (in PySNMP format) to a yaml file that can be used by Datadog's SNMP agent integration
aws_hosts_without_agent.py Python Gets a list of hostnames and IPs for AWS hosts not running the agent
DD Example N/A Spins up a k8s cluster using Minikube with a simple app and database, showcasing the Datadog daemonset, has APM, Logs, and Metrics
get_active_users Python Collects a list of all active (ie. non disabled or pending) users in an organization to a csv file.
Packer Image Build + Terraform Deploy with AWS Secrets Manager and Datadog Agent N/A A guide that helps you to build an AMI with updates + Datadog Agent preinstalled using Packer, and deploy to AWS using Terraform while storing your Datadog API key in AWS Secrets Manager and using an IAM Instance Profile to retrive it at deployment time.
ddog Java 1.8+ A command line tool to troubleshoot connectivity issues for on-premises environments. Ping, SendMetric, SendLog and SendTrace are the available commands.
webhooks N/A A collection of Webhooks examples which use the Datadog API to perform different actions
Metrics Without Limits Optimiser Python Run through your custom metrics to apply a MWL allowlist of tags and aggregations to a metric based on whether the tags/aggregations have been actively queried on by dashboards, notebooks, monitors, and through the API in the past 30 day and only if the resulting volume of this new config is less than not using MWL.
Postgres Database Monitoring Setup Script Python A script to prepare Postgres databases for use with Database Monitoring. Discovers all databases on a databse host, creates datadog user, schema, and explain statments, then confirms the database was prepared properly.

Additional tools

These are some additional tools and scripts written by Datadog.

Name Language Function
csv_exporter Python Exports a given metric from Datadog as a csv

Getting started

For any Python code, you'll want to run:

pip install datadog