> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración con Prometheus

> Exportar métricas de ClickHouse a Prometheus

export const Image = ({img, alt, size = "lg", background}) => {
  const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
  const backgroundColor = background === "white" ? "white" : background === "black" ? "rgb(31 31 28)" : undefined;
  return <div className={`ch-image-${normalizedSize}`}>
      <Frame>
        <img src={img} alt={alt} style={{
    backgroundColor
  }} />
      </Frame>
    </div>;
};

export const BetaBadge = ({link, galaxyTrack, galaxyEvent}) => {
  if (link) {
    return <a href={link} target="_blank" rel="noopener noreferrer" className="betaBadge" onClick={galaxyTrack && galaxyEvent ? galaxyOnClick(galaxyEvent) : undefined}>
                <span>Beta</span>
            </a>;
  }
  return <a href="https://clickhouse.com/docs/reference/settings/beta-and-experimental-features#beta-features" className="betaBadge">
            <span>Funcionalidad beta</span>
        </a>;
};

Esta función admite la integración con [Prometheus](https://prometheus.io/) para supervisar los servicios de ClickHouse Cloud. El acceso a las métricas de Prometheus se ofrece a través del endpoint de la [ClickHouse Cloud API](/es/products/cloud/features/admin-features/api/api-overview), que le permite conectarse de forma segura y exportar métricas a su collector de métricas de Prometheus. Estas métricas pueden integrarse con dashboards como Grafana y Datadog para su visualización.

Las métricas de los [ClickPipes](/es/integrations/clickpipes) asociados a un servicio se incluyen junto con las métricas de ClickHouse de ese servicio.

Para empezar, [genere una API key](/es/products/cloud/features/admin-features/api/openapi).

Si busca el endpoint equivalente para los servicios de [ClickHouse Managed Postgres](/es/products/managed-postgres/overview), consulte el [endpoint de Prometheus de ClickHouse Managed Postgres](/es/products/managed-postgres/monitoring/prometheus).

<div id="prometheus-endpoint-api-to-retrieve-clickhouse-cloud-metrics">
  ## API del endpoint de Prometheus para obtener métricas de ClickHouse Cloud
</div>

<div id="api-reference">
  ### Referencia de la API
</div>

| Método | Ruta                                                                                                                            | Descripción                                                                                                                                                                                       |
| ------ | ------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| GET    | `https://api.clickhouse.cloud/v1/organizations/:organizationId/services/:serviceId/prometheus?filtered_metrics=[true \| false]` | Devuelve las métricas de un servicio específico                                                                                                                                                   |
| GET    | `https://api.clickhouse.cloud/v1/organizations/:organizationId/prometheus?filtered_metrics=[true \| false]`                     | **Obsoleto.** Devuelve las métricas de todos los servicios de una organización                                                                                                                    |
| GET    | `https://api.clickhouse.cloud/v1/organizations/:organizationId/prometheus/discovery?filtered_metrics=[true \| false]`           | Devuelve los destinos de scrape de Prometheus para todos los servicios de una organización, en el formato de [detección de servicios HTTP](https://prometheus.io/docs/prometheus/latest/http_sd/) |

<Note>
  El endpoint de métricas de toda la organización (`GET /v1/organizations/{organizationId}/prometheus`) está obsoleto en favor de la [detección automática de servicios](#automatic-service-discovery). Las organizaciones existentes pueden seguir usándolo; las organizaciones recién creadas usan el endpoint de detección en su lugar. Contacte con el soporte de ClickHouse si necesita acceso a este endpoint.
</Note>

**Parámetros de la solicitud**

| Nombre                | Ubicación             | Tipo               |
| --------------------- | --------------------- | ------------------ |
| ID de la organización | endpoint              | uuid               |
| ID del servicio       | endpoint              | uuid (opcional)    |
| filtered\_metrics     | Parámetro de consulta | boolean (opcional) |

Los esquemas completos de solicitud y respuesta para estos endpoints están disponibles en la [referencia de Cloud API](/es/products/cloud/api-reference/prometheus).

<div id="authentication">
  ### Autenticación
</div>

Utiliza tu API key de ClickHouse Cloud para la autenticación básica:

```bash theme={null}
Username: <KEY_ID>
Password: <KEY_SECRET>
Example request
export KEY_SECRET=<key_secret>
export KEY_ID=<key_id>
export ORG_ID=<org_id>

# Para todos los servicios en $ORG_ID
curl --silent --user $KEY_ID:$KEY_SECRET https://api.clickhouse.cloud/v1/organizations/$ORG_ID/prometheus?filtered_metrics=true

# Solo para un único servicio
export SERVICE_ID=<service_id>
curl --silent --user $KEY_ID:$KEY_SECRET https://api.clickhouse.cloud/v1/organizations/$ORG_ID/services/$SERVICE_ID/prometheus?filtered_metrics=true
```

<div id="sample-response">
  ### Respuesta de ejemplo
</div>

```response theme={null}
# HELP ClickHouse_ServiceInfo Información sobre el servicio, incluido el estado del clúster y la versión de ClickHouse
# TYPE ClickHouse_ServiceInfo untyped
ClickHouse_ServiceInfo{clickhouse_org="c2ba4799-a76e-456f-a71a-b021b1fafe60",clickhouse_service="12f4a114-9746-4a75-9ce5-161ec3a73c4c",clickhouse_service_name="test service",clickhouse_cluster_status="running",clickhouse_version="24.5",scrape="full"} 1

# HELP ClickHouseProfileEvents_Query Número de consultas que se interpretarán y potencialmente ejecutarán. No incluye consultas que no se pudieron analizar o que fueron rechazadas por límites de tamaño de AST, límites de cuota o límites en el número de consultas en ejecución simultánea. Puede incluir consultas internas iniciadas por el propio ClickHouse. No cuenta las subconsultas.
# TYPE ClickHouseProfileEvents_Query counter
ClickHouseProfileEvents_Query{clickhouse_org="c2ba4799-a76e-456f-a71a-b021b1fafe60",clickhouse_service="12f4a114-9746-4a75-9ce5-161ec3a73c4c",clickhouse_service_name="test service",hostname="c-cream-ma-20-server-3vd2ehh-0",instance="c-cream-ma-20-server-3vd2ehh-0",table="system.events"} 6

# HELP ClickHouseProfileEvents_QueriesWithSubqueries Cuenta las consultas con todas sus subconsultas
# TYPE ClickHouseProfileEvents_QueriesWithSubqueries counter
ClickHouseProfileEvents_QueriesWithSubqueries{clickhouse_org="c2ba4799-a76e-456f-a71a-b021b1fafe60",clickhouse_service="12f4a114-9746-4a75-9ce5-161ec3a73c4c",clickhouse_service_name="test service",hostname="c-cream-ma-20-server-3vd2ehh-0",instance="c-cream-ma-20-server-3vd2ehh-0",table="system.events"} 230

# HELP ClickHouseProfileEvents_SelectQueriesWithSubqueries Cuenta las consultas SELECT con todas sus subconsultas
# TYPE ClickHouseProfileEvents_SelectQueriesWithSubqueries counter
ClickHouseProfileEvents_SelectQueriesWithSubqueries{clickhouse_org="c2ba4799-a76e-456f-a71a-b021b1fafe60",clickhouse_service="12f4a114-9746-4a75-9ce5-161ec3a73c4c",clickhouse_service_name="test service",hostname="c-cream-ma-20-server-3vd2ehh-0",instance="c-cream-ma-20-server-3vd2ehh-0",table="system.events"} 224

# HELP ClickHouseProfileEvents_FileOpen Número de archivos abiertos.
# TYPE ClickHouseProfileEvents_FileOpen counter
ClickHouseProfileEvents_FileOpen{clickhouse_org="c2ba4799-a76e-456f-a71a-b021b1fafe60",clickhouse_service="12f4a114-9746-4a75-9ce5-161ec3a73c4c",clickhouse_service_name="test service",hostname="c-cream-ma-20-server-3vd2ehh-0",instance="c-cream-ma-20-server-3vd2ehh-0",table="system.events"} 4157

# HELP ClickHouseProfileEvents_Seek Número de veces que se llamó a la función 'lseek'.
# TYPE ClickHouseProfileEvents_Seek counter
ClickHouseProfileEvents_Seek{clickhouse_org="c2ba4799-a76e-456f-a71a-b021b1fafe60",clickhouse_service="12f4a114-9746-4a75-9ce5-161ec3a73c4c",clickhouse_service_name="test service",hostname="c-cream-ma-20-server-3vd2ehh-0",instance="c-cream-ma-20-server-3vd2ehh-0",table="system.events"} 1840

# HELP ClickPipes_Info Siempre igual a 1. La etiqueta "clickpipe_state" contiene el estado actual del pipe: Stopped/Provisioning/Running/Paused/Failed
# TYPE ClickPipes_Info gauge
ClickPipes_Info{clickhouse_org="11dfa1ec-767d-43cb-bfad-618ce2aaf959",clickhouse_service="82b83b6a-5568-4a82-aa78-fed9239db83f",clickhouse_service_name="ClickPipes demo instace",clickpipe_id="642bb967-940b-459e-9f63-a2833f62ec44",clickpipe_name="Confluent demo pipe",clickpipe_source="confluent",clickpipe_status="Running"} 1

# HELP ClickPipes_SentEvents_Total Número total de registros enviados a ClickHouse
# TYPE ClickPipes_SentEvents_Total counter
ClickPipes_SentEvents_Total{clickhouse_org="11dfa1ec-767d-43cb-bfad-618ce2aaf959",clickhouse_service="82b83b6a-5568-4a82-aa78-fed9239db83f",clickhouse_service_name="ClickPipes demo instace",clickpipe_id="642bb967-940b-459e-9f63-a2833f62ec44",clickpipe_name="Confluent demo pipe",clickpipe_source="confluent"} 5534250

# HELP ClickPipes_SentBytesCompressed_Total Total de bytes comprimidos enviados a ClickHouse.
# TYPE ClickPipes_SentBytesCompressed_Total counter
ClickPipes_SentBytesCompressed_Total{clickhouse_org="11dfa1ec-767d-43cb-bfad-618ce2aaf959",clickhouse_service="82b83b6a-5568-4a82-aa78-fed9239db83f",clickhouse_service_name
="ClickPipes demo instace",clickpipe_id="642bb967-940b-459e-9f63-a2833f62ec44",clickpipe_name="Confluent demo pipe",clickpipe_source="confluent"} 380837520
ClickPipes_SentBytesCompressed_Total{clickhouse_org="11dfa1ec-767d-43cb-bfad-618ce2aaf959",clickhouse_service="82b83b6a-5568-4a82-aa78-fed9239db83f",clickhouse_service_name

# HELP ClickPipes_FetchedBytes_Total Total de bytes sin comprimir obtenidos desde el origen.
# TYPE ClickPipes_FetchedBytes_Total counter
ClickPipes_FetchedBytes_Total{clickhouse_org="11dfa1ec-767d-43cb-bfad-618ce2aaf959",clickhouse_service="82b83b6a-5568-4a82-aa78-fed9239db83f",clickhouse_service_name="ClickPipes demo instace",clickpipe_id="642bb967-940b-459e-9f63-a2833f62ec44",clickpipe_name="Confluent demo pipe",clickpipe_source="confluent"} 873286202

# HELP ClickPipes_Errors_Total Total de errores al ingestar datos.
# TYPE ClickPipes_Errors_Total counter
ClickPipes_Errors_Total{clickhouse_org="11dfa1ec-767d-43cb-bfad-618ce2aaf959",clickhouse_service="82b83b6a-5568-4a82-aa78-fed9239db83f",clickhouse_service_name="ClickPipes demo instace",clickpipe_id="642bb967-940b-459e-9f63-a2833f62ec44",clickpipe_name="Confluent demo pipe",clickpipe_source="confluent"} 0

# HELP ClickPipes_SentBytes_Total Total de bytes sin comprimir enviados a ClickHouse.
# TYPE ClickPipes_SentBytes_Total counter
ClickPipes_SentBytes_Total{clickhouse_org="11dfa1ec-767d-43cb-bfad-618ce2aaf959",clickhouse_service="82b83b6a-5568-4a82-aa78-fed9239db83f",clickhouse_service_name="ClickPipes demo instace",clickpipe_id="642bb967-940b-459e-9f63-a2833f62ec44",clickpipe_name="Confluent demo pipe",clickpipe_source="confluent"} 477187967

# HELP ClickPipes_FetchedBytesCompressed_Total Total de bytes comprimidos obtenidos desde el origen. Si los datos no están comprimidos en el origen, este valor será igual a ClickPipes_FetchedBytes_Total
# TYPE ClickPipes_FetchedBytesCompressed_Total counter
ClickPipes_FetchedBytesCompressed_Total{clickhouse_org="11dfa1ec-767d-43cb-bfad-618ce2aaf959",clickhouse_service="82b83b6a-5568-4a82-aa78-fed9239db83f",clickhouse_service_name="ClickPipes demo instace",clickpipe_id="642bb967-940b-459e-9f63-a2833f62ec44",clickpipe_name="Confluent demo pipe",clickpipe_source="confluent"} 873286202

# HELP ClickPipes_FetchedEvents_Total Número total de registros obtenidos de la fuente.
# TYPE ClickPipes_FetchedEvents_Total counter
ClickPipes_FetchedEvents_Total{clickhouse_org="11dfa1ec-767d-43cb-bfad-618ce2aaf959",clickhouse_service="82b83b6a-5568-4a82-aa78-fed9239db83f",clickhouse_service_name="ClickPipes demo instace",clickpipe_id="642bb967-940b-459e-9f63-a2833f62ec44",clickpipe_name="Confluent demo pipe",clickpipe_source="confluent"} 5535376
```

<div id="metric-labels">
  ### Etiquetas de métricas
</div>

Todas las métricas tienen las siguientes etiquetas:

| Etiqueta                  | Descripción           |
| ------------------------- | --------------------- |
| clickhouse\_org           | ID de la organización |
| clickhouse\_service       | ID del servicio       |
| clickhouse\_service\_name | Nombre del servicio   |

En ClickPipes, las métricas también tendrán las siguientes etiquetas:

| Etiqueta          | Descripción                 |
| ----------------- | --------------------------- |
| clickpipe\_id     | ID de ClickPipe             |
| clickpipe\_name   | Nombre de ClickPipe         |
| clickpipe\_source | Tipo de origen de ClickPipe |

<div id="information-metrics">
  ### Métricas de información
</div>

ClickHouse Cloud proporciona una métrica especial `ClickHouse_ServiceInfo`, que es un `gauge` y siempre tiene el valor `1`. Esta métrica contiene todas las **Etiquetas de métricas**, así como las siguientes etiquetas:

| Label                       | Description                                                                                                                      |           |            |        |            |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------- | --------- | ---------- | ------ | ---------- |
| clickhouse\_cluster\_status | Estado del servicio. Puede ser uno de los siguientes: \[`awaking`                                                                | `running` | `degraded` | `idle` | `stopped`] |
| clickhouse\_version         | Versión del servidor de ClickHouse que ejecuta el servicio                                                                       |           |            |        |            |
| scrape                      | Indica el estado del último scrape. Puede ser `full` o `partial`                                                                 |           |            |        |            |
| full                        | Indica que no hubo errores durante el último scrape de métricas                                                                  |           |            |        |            |
| partial                     | Indica que hubo algunos errores durante el último scrape de métricas y que solo se devolvió la métrica `ClickHouse_ServiceInfo`. |           |            |        |            |

Las solicitudes para recuperar métricas no reactivarán un servicio inactivo. Si un servicio está en estado `idle`, solo se devolverá la métrica `ClickHouse_ServiceInfo`.

Para ClickPipes, hay una métrica `gauge` similar, `ClickPipes_Info`, que además de las **Etiquetas de métricas** contiene las siguientes etiquetas:

| Label            | Description               |
| ---------------- | ------------------------- |
| clickpipe\_state | El estado actual del pipe |

<div id="configuring-prometheus">
  ### Configuración de Prometheus
</div>

El servidor Prometheus recopila métricas de los destinos configurados en los intervalos especificados. A continuación, se muestra un ejemplo de configuración para que el servidor Prometheus use el endpoint de Prometheus de ClickHouse Cloud:

```yaml theme={null}
global:
  scrape_interval: 15s

scrape_configs:
  - job_name: "prometheus"
    static_configs:
    - targets: ["localhost:9090"]
  - job_name: "clickhouse"
    static_configs:
      - targets: ["api.clickhouse.cloud"]
    scheme: https
    params:
      filtered_metrics: ["true"]
    metrics_path: "/v1/organizations/<ORG_ID>/prometheus"
    basic_auth:
      username: <KEY_ID>
      password: <KEY_SECRET>
    honor_labels: true
```

Ten en cuenta que el parámetro de configuración `honor_labels` debe establecerse en `true` para que la etiqueta de instancia se rellene correctamente. Además, en el ejemplo anterior `filtered_metrics` está establecido en `true`, pero debe configurarse según las preferencias del usuario.

<div id="automatic-service-discovery">
  ### Detección automática de servicios
</div>

<BetaBadge />

El endpoint de descubrimiento devuelve un destino de scrape por cada servicio de su organización, en el formato de [detección de servicios HTTP](https://prometheus.io/docs/prometheus/latest/http_sd/) (`http_sd`) de Prometheus. Prometheus actualiza la lista de destinos en cada sondeo de descubrimiento y recopila métricas de cada destino detectado, por lo que los servicios recién creados se incluyen automáticamente y los servicios eliminados se quitan de la lista de destinos. Solo se incluyen los servicios que su API key tiene autorización para ver; se omiten los servicios que se están eliminando o que ya se han eliminado.

Para usarlo, configure un job de [`http_sd_configs`](https://prometheus.io/docs/prometheus/latest/configuration/configuration/#http_sd_config) para que apunte al endpoint de descubrimiento:

```yaml theme={null}
global:
  scrape_interval: 15s

scrape_configs:
  - job_name: "clickhouse"
    http_sd_configs:
      - url: https://api.clickhouse.cloud/v1/organizations/<ORG_ID>/prometheus/discovery
        refresh_interval: 60s
        basic_auth:
          username: <KEY_ID>
          password: <KEY_SECRET>
    basic_auth:
      username: <KEY_ID>
      password: <KEY_SECRET>
    honor_labels: true
```

Configure `basic_auth` en ambos lugares: el bloque de `http_sd_configs` autentica los sondeos de detección y el bloque del trabajo de scrape autentica la recopilación de métricas de cada servicio. Al igual que con la configuración estática, establezca `honor_labels: true` para que la etiqueta de instancia se rellene correctamente.

Una respuesta de detección de ejemplo:

```json theme={null}
[
  {
    "targets": ["api.clickhouse.cloud"],
    "labels": {
      "__scheme__": "https",
      "__metrics_path__": "/v1/organizations/<ORG_ID>/services/<SERVICE_ID>/prometheus",
      "__param_filtered_metrics": "true",
      "clickhouse_org_id": "<ORG_ID>",
      "clickhouse_service_id": "<SERVICE_ID>",
      "clickhouse_discovery_service_name": "my service"
    }
  }
]
```

Los destinos detectados se recopilan con `filtered_metrics=true`. Para detectar destinos que recopilan el conjunto completo de métricas, añada `?filtered_metrics=false` a la URL de discovery. La especificación completa del endpoint está disponible en la [referencia de Cloud API](/es/products/cloud/api-reference/prometheus/organization-prometheus-discovery-get).

<div id="integrating-with-grafana">
  ## Integración con Grafana
</div>

Los usuarios disponen de dos formas principales de integrarse con Grafana:

* **Endpoint de métricas** – Este enfoque tiene la ventaja de no requerir componentes ni infraestructura adicionales. Esta opción está limitada a Grafana Cloud y solo requiere la URL del endpoint de Prometheus de ClickHouse Cloud y las credenciales.
* **Grafana Alloy** - Grafana Alloy es una distribución agnóstica del proveedor del OpenTelemetry (OTel) Collector que sustituye a Grafana Agent. Puede usarse como scraper, implementarse en su propia infraestructura y es compatible con cualquier endpoint de Prometheus.

A continuación, proporcionamos instrucciones para usar estas opciones, centrándonos en los detalles específicos del endpoint de Prometheus de ClickHouse Cloud.

<div id="grafana-cloud-with-metrics-endpoint">
  ### Grafana Cloud con endpoint de métricas
</div>

* Inicia sesión en tu cuenta de Grafana Cloud
* Añade una nueva conexión seleccionando el **endpoint de métricas**
* Configura la URL de scrape para que apunte al endpoint de Prometheus y usa autenticación básica para configurar la conexión con la API key/secret
* Prueba la conexión para asegurarte de que se establece correctamente

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/uBraLefhLowMlCJn/images/integrations/prometheus-grafana-metrics-endpoint.webp?fit=max&auto=format&n=uBraLefhLowMlCJn&q=85&s=2b4bb926af448635faa3e32bcc2fb3d6" size="md" alt="Configurar el endpoint de métricas de Grafana" border width="1784" height="1048" data-path="images/integrations/prometheus-grafana-metrics-endpoint.webp" />

<br />

Una vez configurado, deberías ver las métricas en el menú desplegable, que puedes seleccionar para configurar dashboards:

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/uBraLefhLowMlCJn/images/integrations/prometheus-grafana-dropdown.webp?fit=max&auto=format&n=uBraLefhLowMlCJn&q=85&s=5624b8819b66df854a1f87e53424b7b4" size="md" alt="Menú desplegable del explorador de métricas de Grafana" border width="1238" height="876" data-path="images/integrations/prometheus-grafana-dropdown.webp" />

<br />

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/uBraLefhLowMlCJn/images/integrations/prometheus-grafana-chart.webp?fit=max&auto=format&n=uBraLefhLowMlCJn&q=85&s=bcbf54776721721ac301cd781263205b" size="md" alt="Gráfico del explorador de métricas de Grafana" border width="2236" height="628" data-path="images/integrations/prometheus-grafana-chart.webp" />

<div id="grafana-cloud-with-alloy">
  ### Grafana Cloud con Alloy
</div>

Si usas Grafana Cloud, puedes instalar Alloy desde el menú Alloy en Grafana siguiendo las instrucciones en pantalla:

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/uBraLefhLowMlCJn/images/integrations/prometheus-grafana-alloy.webp?fit=max&auto=format&n=uBraLefhLowMlCJn&q=85&s=b198e035c0ddc712925111e5688c59e5" size="md" alt="Grafana Alloy" border width="1208" height="1118" data-path="images/integrations/prometheus-grafana-alloy.webp" />

<br />

Esto debería configurar Alloy con un componente `prometheus.remote_write` para enviar datos a un endpoint de Grafana Cloud con un token de autenticación. Después, solo tendrás que modificar la configuración de Alloy (ubicada en `/etc/alloy/config.alloy` en Linux) para incluir un scraper para el endpoint de Prometheus de ClickHouse Cloud.

A continuación se muestra una configuración de ejemplo de Alloy con un componente `prometheus.scrape` para recopilar métricas del ClickHouse Cloud Endpoint, junto con el componente `prometheus.remote_write` configurado automáticamente. Ten en cuenta que el componente de configuración `basic_auth` contiene el ID y el secreto de nuestra API key de Cloud como nombre de usuario y contraseña, respectivamente.

```yaml theme={null}
prometheus.scrape "clickhouse_cloud" {
  targets = [{
  __address__ = "api.clickhouse.cloud",
  }]

  scheme       = "https"
  metrics_path = "/v1/organizations/<clickhouse_org_id>/prometheus"

  params = {
  "filtered_metrics" = ["true"],
  }

  honor_labels    = true
  scrape_interval = "30s"
  scrape_timeout  = "25s"

  basic_auth {
  username = "<clickhouse_api_key_id>"
  password = "<clickhouse_api_key_secret>"
  }

  forward_to = [prometheus.remote_write.grafana_cloud.receiver]
}

  prometheus.remote_write "grafana_cloud" {
  endpoint {
  url = "https://<grafana_prometheus_url>/api/prom/push"

  basic_auth {
  username = "<grafana_username>"
  password = "<grafana_api_token>"
  }
  }
}
```

Tenga en cuenta que el parámetro de configuración `honor_labels` debe establecerse en `true` para que la etiqueta de la instancia se rellene correctamente.

<div id="grafana-self-managed-with-alloy">
  ### Grafana autogestionado con Alloy
</div>

Los usuarios de Grafana autogestionado pueden encontrar las instrucciones para instalar el agente Alloy [aquí](https://grafana.com/docs/alloy/latest/get-started/install/). Suponemos que los usuarios han configurado Alloy para enviar métricas de Prometheus al destino deseado. El componente `prometheus.scrape` que aparece a continuación hace que Alloy recopile métricas del ClickHouse Cloud Endpoint. Suponemos que `prometheus.remote_write` recibe las métricas recopiladas. Ajuste la clave `forward_to` para que apunte al destino de destino si esta no existe.

```yaml theme={null}
// prometheus.scrape component causes Alloy to scrape the ClickHouse Cloud Prometheus endpoint.
  // Adjust the forward_to key to match your remote_write receiver if it differs.
  prometheus.scrape "clickhouse_cloud" {
  targets = [{
  __address__ = "api.clickhouse.cloud",
  }]

  scheme       = "https"
  metrics_path = "/v1/organizations/<organizationId>/prometheus"

  params = {
  "filtered_metrics" = ["true"],
  }

  honor_labels = true

  basic_auth {
  username = "<KEY_ID>"
  password = "<KEY_SECRET>"
  }

  forward_to = [prometheus.remote_write.metrics_service.receiver]
}
```

Una vez configurado, deberías ver las métricas relacionadas con ClickHouse en el explorador de métricas:

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/uBraLefhLowMlCJn/images/integrations/prometheus-grafana-metrics-explorer.webp?fit=max&auto=format&n=uBraLefhLowMlCJn&q=85&s=5b2626ab138ec9cea6d49c3215a6f7a5" size="md" alt="Explorador de métricas de Grafana" border width="2232" height="1146" data-path="images/integrations/prometheus-grafana-metrics-explorer.webp" />

<br />

Ten en cuenta que el parámetro de configuración `honor_labels` debe establecerse en `true` para que la etiqueta `instance` se rellene correctamente.

<div id="integrating-with-datadog">
  ## Integración con Datadog
</div>

Puedes usar el [Agent](https://docs.datadoghq.com/agent/?tab=Linux) de Datadog y la [integración de OpenMetrics](https://docs.datadoghq.com/integrations/openmetrics/) para recopilar métricas desde el endpoint de ClickHouse Cloud. A continuación se muestra un ejemplo sencillo de configuración para este agente y esta integración. No obstante, ten en cuenta que quizá te convenga seleccionar solo las métricas que más te interesen. El ejemplo genérico que aparece a continuación exportará muchos miles de combinaciones de métricas e instancias que Datadog tratará como métricas personalizadas.

```yaml theme={null}
init_config:

instances:
   - openmetrics_endpoint: 'https://api.clickhouse.cloud/v1/organizations/97a33bdb-4db3-4067-b14f-ce40f621aae1/prometheus?filtered_metrics=true'
     namespace: 'clickhouse'
     metrics:
         - '^ClickHouse.*'
     username: username
     password: password
```

<br />

<Image img="https://mintcdn.com/private-7c7dfe99-vortex-format/uBraLefhLowMlCJn/images/integrations/prometheus-datadog.webp?fit=max&auto=format&n=uBraLefhLowMlCJn&q=85&s=18f48e28b71000201b26ac8676fb4b7d" size="md" alt="Integración de Datadog con Prometheus" width="1452" height="762" data-path="images/integrations/prometheus-datadog.webp" />

<div id="related">
  ## Páginas relacionadas
</div>

* [Resumen de monitorización](/es/products/cloud/features/monitoring/overview) — Compare todos los enfoques de monitorización para ClickHouse Cloud
* [Monitorización en Cloud Console](/es/products/cloud/features/monitoring/cloud-console) — Dashboards integrados que no requieren herramientas externas
* [Integraciones de la comunidad y de socios](/es/products/cloud/features/monitoring/integrations) — Integración con el agente de Datadog y soluciones de la comunidad
* [Consulta de tablas del sistema](/es/products/cloud/features/monitoring/system-tables) — Acceso directo por SQL a las métricas del sistema
* [endpoint de Prometheus de ClickHouse Managed Postgres](/es/products/managed-postgres/monitoring/prometheus) — Extraiga métricas de sus servicios de ClickHouse Managed Postgres