Overview
Cloudsmith is a fully managed cloud-native package management platform, used to securely store, manage, and distribute software artifacts for DevOps teams. It supports all major formats including Docker, npm, Maven, Python, RubyGems, and more, with enterprise-grade access control, policy enforcement, and auditing.
This integration enhances visibility into your Cloudsmith organization by collecting real-time observability data and surfacing it within the Datadog platform. Teams can monitor resource usage, enforce security compliance, and audit user activity-directly from within Datadog dashboards and monitors.
The integration collects data from Cloudsmith’s APIs and maps them to the following Datadog telemetry types:
- Metrics: Storage and bandwidth usage, token activity, and active user metrics.
- Events: Security vulnerability findings, audit log activity, license and vulnerability policy violations, member summaries, and quota usage snapshots.
- Service Checks: Health status of quota consumption and API connectivity.
With this integration, customers gain centralized observability over their Cloudsmith package infrastructure, helping enforce compliance, troubleshoot issues faster, and optimize resource planning.
Setup
The Cloudsmith check is not included in the Datadog Agent package, so you need to install it.
Installation
For Agent v7.21+ / v6.21+, follow the instructions below to install the Cloudsmith check on your host. See Use Community Integrations to install with the Docker Agent or earlier versions of the Agent.
Run the following command to install the Agent integration:
datadog-agent integration install -t datadog-cloudsmith==1.0.0
Configure your integration similar to core integrations.
Configuration
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.
Data Collected
Metrics
cloudsmith.storage_used
(gauge) | The percentage of storage used
Shown as percent |
cloudsmith.bandwidth_used
(gauge) | The percentage of bandwidth used
Shown as percent |
cloudsmith.token_count
(gauge) | The number of tokens in an organization
Shown as item |
cloudsmith.token_bandwidth_total
(gauge) | The total bandwidth used by tokens
Shown as byte |
cloudsmith.token_download_total
(gauge) | The total downloads used by tokens
Shown as item |
cloudsmith.storage_used_bytes
(gauge) | The amount of storage used in bytes
Shown as byte |
cloudsmith.bandwidth_used_bytes
(gauge) | The amount of bandwidth used in bytes
Shown as byte |
cloudsmith.member.active
(gauge) | The number of active members in the organization
Shown as item |
cloudsmith.license_policy_violation.count
(gauge) | The number of license policy violations
Shown as item |
cloudsmith.vulnerability_policy_violation.count
(gauge) | The number of vulnerability policy violations
Shown as item |
cloudsmith.member.has_2fa.count
(gauge) | The number of members with 2FA enabled
Shown as item |
cloudsmith.member.saml.count
(gauge) | The number of members who logged in with SAML
Shown as item |
cloudsmith.member.password.count
(gauge) | The number of members who logged in with password
Shown as item |
cloudsmith.member.owner.count
(gauge) | The number of users with role 'Owner'
Shown as item |
cloudsmith.member.manager.count
(gauge) | The number of users with role 'Manager'
Shown as item |
cloudsmith.member.readonly.count
(gauge) | The number of users with role 'ReadOnly'
Shown as item |
cloudsmith.member.admin.count
(gauge) | The number of users with role 'Admin'
Shown as item |
cloudsmith.bandwidth_plan_limit_bytes
(gauge) | The bandwidth limit in bytes defined by the plan
Shown as byte |
cloudsmith.bandwidth_plan_limit_gb
(gauge) | The bandwidth limit in gigabytes defined by the plan
Shown as byte |
cloudsmith.bandwidth_used_gb
(gauge) | The bandwidth used in gigabytes
Shown as byte |
cloudsmith.storage_plan_limit_bytes
(gauge) | The storage limit in bytes defined by the plan
Shown as byte |
cloudsmith.storage_plan_limit_gb
(gauge) | The storage limit in gigabytes defined by the plan
Shown as byte |
cloudsmith.storage_used_gb
(gauge) | The storage used in gigabytes
Shown as byte |
Events
All Cloudsmith-related events collected appear within the Datadog Event Explorer with the source:cloudsmith tag. Events are collected every five minutes to reduce the number of requests sent to the Cloudsmith API.
There are several types of events available:
- Audit Logs event
- Security Scan event
- Vulnerability Policy Violation event
- License Policy Violation event
- Organization Members summary
- Quota (Raw Usage) Summary
Support
Need help? Contact Cloudsmith support.
