Cloudsmith es una plataforma de gestión de paquetes nativa en la nube totalmente gestionada, utilizada para almacenar, gestionar y distribuir de forma segura artefactos de software para equipos de DevOps. Es compatible con los principales formatos, incluidos Docker, npm, Maven, Python, RubyGems, etc., con control de acceso, aplicación de políticas y auditoría de nivel empresarial.
Esta integración mejora la visibilidad de tu organización de Cloudsmith recopilando datos de observabilidad en tiempo real y mostrándolos en la plataforma de Datadog. Teams puede monitorizar el uso de recursos, reforzar el cumplimiento de la seguridad y auditar la actividad de los usuarios, directamente desde los dashboards y monitores de Datadog.
La integración recopila datos de las API de Cloudsmith y los asigna a los siguientes tipos de telemetría de Datadog:
- Métricas: uso de almacenamiento y ancho de banda, actividad de tokens y métricas de usuarios activos.
- Eventos: detección de vulnerabilidades de seguridad, actividad de logs de auditoría, infracciones de las políticas de licencias y vulnerabilidades, resúmenes de miembros y snapshots de uso de cuotas.
- Checks de servicio: estado del consumo de cuotas y conectividad de la API.
Con esta integración, los clientes obtienen una capacidad de observación centralizada de su infraestructura de paquetes de Cloudsmith, lo que les ayuda a cumplir las normativas, solucionar problemas más rápidamente y optimizar la planificación de recursos.
Configuración
La comprobación de Cloudsmith no está incluida en el paquete del Datadog Agent, por lo que es necesario instalarlo.
Instalación
Para Agent v7.21+/v6.21+, sigue las instrucciones a continuación para instalar el check de Cloudsmith en tu host. Consulta Use Community Integrations para instalar con el Docker Agent o versiones anteriores de Agent.
Ejecuta el siguiente comando para instalar la integración del Agent:
datadog-agent integration install -t datadog-cloudsmith==1.1.0
Configura tu integración de forma similar a las [integraciones] centrales (https://docs.datadoghq.com/getting_started/integrations/).
Configuración
Edita el archivo cloudsmith.d/conf.yaml
, en la carpeta conf.d/
en la raíz del directorio de configuración de tu Agent para empezar a recopilar tus datos de rendimiento de Cloudsmith. Consulta el [cloudsmith.d/conf.yaml](https://github.com/DataDog/integrations-extras/blob/master/cloudsmith/datadog_checks/cloudsmith/data/conf.yaml.example de ejemplo) para ver todas las opciones de configuración disponibles.
Reinicia el Agent.
Validación
Ejecuta el subcomando de estado del Agent y busca cloudsmith
en la sección Checks.
Datos recopilados
Métricas
| |
---|
cloudsmith.storage_used (gauge) | El porcentaje de almacenamiento utilizado Se muestra en porcentaje. |
cloudsmith.bandwidth_used (gauge) | El porcentaje de ancho de banda utilizado Se muestra en porcentaje |
cloudsmith.token_count (gauge) | El número de tokens de una organización Se muestra como elemento |
cloudsmith.token_bandwidth_total (gauge) | El ancho de banda total utilizado por los tokens Se muestra como byte |
cloudsmith.token_download_total (gauge) | El total de descargas utilizadas por los tokens Se muestra como elemento |
cloudsmith.storage_used_bytes (gauge) | La cantidad de almacenamiento utilizado en bytes Se muestra como byte |
cloudsmith.bandwidth_used_bytes (gauge) | La cantidad de ancho de banda utilizado en bytes Se muestra como byte |
cloudsmith.member.active (gauge) | El número de miembros activos en la organización Se muestra como elemento |
cloudsmith.license_policy_violation.count (gauge) | El número de violaciones de la política de licencias Se muestra como elemento |
cloudsmith.vulnerability_policy_violation.count (gauge) | El número de violaciones de la política de vulnerabilidad Se muestra como elemento |
cloudsmith.member.has_2fa.count (gauge) | El número de miembros con 2FA activado Se muestra como elemento |
cloudsmith.member.saml.count (gauge) | El número de miembros que iniciaron sesión con SAML Se muestra como elemento |
cloudsmith.member.password.count (gauge) | El número de miembros que se conectaron con la contraseña Se muestra como elemento |
cloudsmith.member.owner.count (gauge) | El número de usuarios con rol ‘Propietario’ Se muestra como elemento |
cloudsmith.member.manager.count (gauge) | El número de usuarios con rol ‘Administrador’ Se muestra como elemento |
cloudsmith.member.readonly.count (gauge) | El número de usuarios con rol ‘Solo lectura’ Se muestra como elemento |
cloudsmith.member.admin.count (gauge) | El número de usuarios con rol ‘Admin’ Se muestra como elemento |
cloudsmith.bandwidth_plan_limit_bytes (gauge) | El límite de ancho de banda en bytes definido por el plan Se muestra como byte |
cloudsmith.bandwidth_plan_limit_gb (gauge) | El límite de ancho de banda en gigabytes definido por el plan Se muestra como byte |
cloudsmith.bandwidth_used_gb (gauge) | El ancho de banda utilizado en gigabytes Se muestra como byte |
cloudsmith.storage_plan_limit_bytes (gauge) | El límite de almacenamiento en bytes definido por el plan Se muestra como byte |
cloudsmith.storage_plan_limit_gb (gauge) | El límite de almacenamiento en gigabytes definido por el plan Se muestra como byte |
cloudsmith.storage_used_gb (gauge) | El almacenamiento utilizado en gigabytes Se muestra como byte |
cloudsmith.storage_configured_bytes (gauge) | El almacenamiento configurado en bytes, incluido el plan y el exceso Se muestra como byte |
cloudsmith.storage_configured_gb (gauge) | El almacenamiento configurado en gigabytes, incluido el plan y el exceso Se muestra como byte |
cloudsmith.bandwidth_configured_gb (gauge) | El ancho de banda configurado en gigabytes, incluido el plan y el exceso Se muestra como byte |
cloudsmith.bandwidth_configured_bytes (gauge) | El ancho de banda configurado en bytes, incluido el plan y el exceso Se muestra como byte |
Checks de servicio
cloudsmith.storage
Devuelve CRITICAL
si el uso es superior al 85 %, WARNING
si el uso es superior al 75 %, en caso contrario devuelve OK
.
Estados: ok, warning, critical, unknown
cloudsmith.bandwidth
Devuelve CRITICAL
si el uso es superior al 85 %, WARNING
si el uso es superior al 75 %, en caso contrario devuelve OK
Estados: ok, warning, critical, unknown
cloudsmith.can_connect
Devuelve CRITICAL si el Agent no puede conectarse a Cloudsmith para recopilar métricas, en caso contrario devuelve OK
Estados: ok, critical
Eventos
Todos los eventos recopilados relacionados con Cloudsmith aparecen en Datadog Event Explorer con la etiqueta source (fuente):cloudsmith
. Los eventos se recopilan cada cinco minutos para reducir el número de solicitudes enviadas a la API de Cloudsmith.
Hay varios tipos de eventos disponibles:
- Evento de logs de auditoría
- Evento de exploración de seguridad
- Evento de violación de la política de vulnerabilidad
- Acto de violación de la política de licencias
- Resumen de los miembros de la organización
- Resumen de cuotas (uso bruto)
Soporte
¿Necesitas ayuda? Ponte en contacto con el soporte de Cloudsmith.