Cloudsmith

Supported OS Linux Windows Mac OS

Integration version1.0.0

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.

  1. Run the following command to install the Agent integration:

    datadog-agent integration install -t datadog-cloudsmith==1.0.0
    
  2. Configure your integration similar to core integrations.

Configuration

  1. 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.

  2. 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.

PREVIEWING: sabrenner/llmobs-proxy-service-quickstart-guide