Datadog
The Datadog Cloudsmith Integration is a simple and effective visualization tool for monitoring your token, storage, bandwidth usage, audit logs, and vulnerability scanning.
Datadog is an observability service for cloud-scale apps, providing monitoring of servers, databases, tools, and services through a SaaS-based data analytics platform. At Cloudsmith, we are big fans of Datadog and use it to monitor and visualize how our system is performing across a range of services and tools.
The Datadog Cloudsmith integration allows you to monitor storage, bandwidth, token usage, audit logs, and vulnerability scan results in Datadog. This metric data is helpful in monitoring your consumption and managing your Cloudsmith usage, including artifact data and package delivery. Along with Cloudsmith tools like audit logs and security scanning, we're trying to help you spot if suspicious activity is going on in your organization, and that any suspicious trails can be caught.
Metrics Available
The following metrics will be tracked by the Datadog Cloudsmith integration:
| Metric Name | Metric Type | Description |
|---|---|---|
| cloudsmith.storage_used | percent | The percentage of artifact data (storage) allowance used |
| cloudsmith.bandwidth_used | percent | The percentage of pacakge delivery (bandwidth) allowance used |
| cloudsmith.token_count | item | The number of tokens in a workspace |
| cloudsmith.token_bandwidth_total | byte | The total package delivery (bandwidth) consumed by tokens |
| cloudsmith.token_download_total | item | The total downloads consumed by tokens |
| cloudsmith.audit_log | event | Most recent audit logs will appear in the stream |
| cloudsmith.vulnerabilities | event | Most recent security scan results |
Install Cloudsmith Datadog Integration
The Cloudsmith Datadog Integration is a Datadog Community Integration. Follow these steps to install and configure it.
Datadog Agent
First things first, you need to install the Datadog Agent.
The Datadog agent is software that runs on your hosts. It collects events and metrics from hosts and sends them to Datadog, where you can analyze your monitoring and performance data. To install the Datadog agent, follow the steps here.
Cloudsmith Datadog Integration Installation
The Cloudsmith check is a Community Integration and is not included in the Datadog Agent package, so you need to install it.
For Agent v7.21+ / v6.21+, follow the instructions below to install the Cloudsmith check on your host. Run the following command to install the Cloudsmith Agent integration:
datadog-agent integration install -t datadog-cloudsmith==<INTEGRATION_VERSION>
Configuration
Configure your integration similar to core integrations. The Cloudsmith integration has 3 configuration values:
| Config Name | Config Description |
|---|---|
| url | This is the url to the Cloudsmith API and will not change (https://api.cloudsmith.io/v1) |
| cloudsmith_api_key | Your Cloudsmith API key |
| organization | The Cloudsmith Organization that you are monitoring |
Follow these steps to configure your Cloudsmith Datadog Integration:
- Edit the cloudsmith.d/conf.yaml file, in the conf.d/ folder at the root of your Agent's configuration directory to start collecting your Cloudsmith performance data. See the sample cloudsmith.d/conf.yaml for all available configuration options.
- Restart the Agent.
Validation
Run the Agent's status subcommand and look for cloudsmith under the Checks section.
View your Cloudsmith Dashboard in Datadog
Datadog dashboards enable you to efficiently monitor your infrastructure and integrations by displaying and tracking key metrics. Once the Agent is installed with the Cloudsmith check, you can use the metrics in any Datadog dashboard.
To make life easier for you, the Cloudsmith Datadog Integration comes with its own dashboard allowing you to monitor your Cloudsmith workspace's artifact data, package delivery, and token usage.
Install the Datadog Integration
Log into Datadog and from the side bar select Integrations->integrations and select the Cloudsmith integration.
Open the Configuration tab and select Install Integration.
The Cloudsmith Dashboard can be viewed by following these instructions:
- Follow the instructions in the previous section to install the Cloudsmith integration
- From Datadog, select Dashboards->Dashboard list to view your dashboards.
Select your installed Cloudsmith dashboard - it will be listed as Cloudsmith Overview.
The dashboard above tracks tokens and consumption usage in a Cloudsmith workspace:
- It tracks the artifact data and package delivery usage of your packages in a Cloudsmith organization. If your usage is getting close to the monthly limit, your status changes to amber if above 75% and red if your usage is above 85%.
- Track your entitlement token usage for your Cloudsmith workspace. View the number of tokens created, the total number of packages delivered by all tokens, and the total package delivery (in GB) delivered by tokens. Entitlement tokens are read-only tokens used for delivering packages and gaining read-only access to Cloudsmith repository contents. See Entitlements for more information.
Furthermore, you can also track org-wide audit logs and vulnerability scanning results across your Cloudsmith workspace. This allows for a one-stop-shop when it comes to visibility over your current artifacts.
To Sum it Up
The Datadog Cloudsmith Integration is a simple and effective visualization tool for monitoring your token, artifact data, package delivery, audit logs, and vulnerability scanning. Manage your monthly usage, and give yourself time to change your settings before you reach your limit. If you identify a limit that is approaching a threshold, then you can quickly and easily adjust your limits at any time within the Cloudsmith UI.
If you already use Datadog to monitor your tools and services, this tool is for you!
Updated about 14 hours ago