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

# Solo HyperDX

> Implementación únicamente de HyperDX

export const Image = ({img, alt, size}) => {
  return <Frame>
      <img src={img} alt={alt} />
    </Frame>;
};

Esta opción está pensada para quienes ya cuentan con una instancia de ClickHouse en ejecución con datos de observabilidad o eventos.

HyperDX puede usarse de forma independiente del resto del stack y es compatible con cualquier esquema de datos, no solo con OpenTelemetry (OTel). Esto lo hace adecuado para canalizaciones de observabilidad personalizadas ya construidas sobre ClickHouse.

Para habilitar toda la funcionalidad, debe proporcionar una instancia de MongoDB para almacenar el estado de la aplicación, incluidos dashboards, búsquedas guardadas, configuraciones de usuario y alertas.

En este modo, la ingestión de datos queda completamente en manos del usuario. Puede ingestar datos en ClickHouse usando su propio OpenTelemetry collector alojado, ingestión directa desde bibliotecas cliente, motores de tabla nativos de ClickHouse (como Kafka o S3), canalizaciones ETL o servicios de ingestión gestionados como ClickPipes. Este enfoque ofrece la máxima flexibilidad y resulta adecuado para equipos que ya operan ClickHouse y quieren añadir HyperDX para visualización, búsqueda y alertas.

<div id="suitable-for">
  ### Recomendado para
</div>

* Usuarios actuales de ClickHouse
* Canalizaciones de eventos personalizadas

<div id="deployment-steps">
  ## Pasos de despliegue
</div>

<br />

<Steps>
  <Step>
    ### Despliegue con Docker

    Ejecuta el siguiente comando y modifica `YOUR_MONGODB_URI` según sea necesario.

    ```shell theme={null}
    docker run -e MONGO_URI=mongodb://YOUR_MONGODB_URI -p 8080:8080 docker.hyperdx.io/hyperdx/hyperdx
    ```
  </Step>

  <Step>
    ### Accede a la UI de HyperDX

    Visita [http://localhost:8080](http://localhost:8080) para acceder a la UI de HyperDX.

    Crea un usuario e introduce un nombre de usuario y una contraseña que cumplan los requisitos.

    Al hacer clic en `Create`, se te pedirán los detalles de conexión.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/16jdCy1HTWZ9Bvmz/images/use-cases/observability/hyperdx-login.png?fit=max&auto=format&n=16jdCy1HTWZ9Bvmz&q=85&s=6584c04fd42475189e28a0827d14d0f6" alt="UI de HyperDX" size="lg" width="3600" height="1900" data-path="images/use-cases/observability/hyperdx-login.png" />
  </Step>

  <Step>
    ### Completa los detalles de conexión

    Conéctate a tu propio clúster externo de ClickHouse, por ejemplo, ClickHouse Cloud.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8a08bda2/16jdCy1HTWZ9Bvmz/images/use-cases/observability/hyperdx-2.png?fit=max&auto=format&n=16jdCy1HTWZ9Bvmz&q=85&s=45243f0126c49b735eb0f6aa3b8636ee" alt="Inicio de sesión de HyperDX" size="md" width="1966" height="1392" data-path="images/use-cases/observability/hyperdx-2.png" />

    Si se te pide crear un origen de datos, conserva todos los valores predeterminados y completa el campo `Table` con el valor `otel_logs`. El resto de la configuración debería detectarse automáticamente, por lo que podrás hacer clic en `Save New Source`.

    <Info>
      **Creación de un origen de datos**

      Para crear un origen de datos, las tablas deben existir en ClickHouse. Si no tienes datos, te recomendamos desplegar el ClickStack OpenTelemetry collector para crear las tablas.
    </Info>
  </Step>
</Steps>

<div id="using-docker-compose">
  ## Uso de Docker Compose
</div>

Puedes modificar la [configuración de Docker Compose](/es/clickstack/deployment/docker-compose) para conseguir el mismo resultado que en esta guía, eliminando el OTel collector y la instancia de ClickHouse del manifiesto.

<div id="otel-collector">
  ## ClickStack OpenTelemetry collector
</div>

Incluso si administras tu propio OpenTelemetry collector, de forma independiente del resto de componentes del stack, seguimos recomendando usar la distribución del colector de ClickStack. Esto garantiza que se use el esquema predeterminado y que se apliquen las buenas prácticas de ingestión.

Para obtener más información sobre cómo desplegar y configurar un colector independiente, consulta ["Ingestión con OpenTelemetry"](/es/clickstack/ingesting-data/collector#modifying-otel-collector-configuration).

<div id="schema-choice-map-vs-json">
  ## Elección del esquema: Map vs JSON
</div>

ClickStack almacena los atributos como columnas `Map(LowCardinality(String), String)` de forma predeterminada. Este es el esquema recomendado para las cargas de trabajo de observabilidad. En combinación con la [serialización de mapas por buckets](/es/reference/data-types/map#bucketed-map-serialization) y los índices de texto sobre las claves y los valores del mapa, ofrece lookups selectivos sin la sobrecarga de ingesta por clave de las subcolumnas JSON dinámicas.

También hay disponible, en fase beta, un esquema de tipo `JSON` para evaluarlo en cargas de trabajo con un conjunto pequeño y estable de claves de atributos. **No se recomienda** como opción predeterminada. Consulta [Map vs tipo JSON](/es/clickstack/ingesting-data/schema/map-vs-json) para ver la comparación completa y las variables de entorno necesarias para habilitar la compatibilidad con JSON.