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

# HyperDX uniquement

> Déploiement d’HyperDX uniquement

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

Cette option est destinée aux cas où vous disposez déjà d'une instance ClickHouse en cours d'exécution contenant des données d'observabilité ou d'événements.

HyperDX peut être utilisé indépendamment du reste de la stack et est compatible avec n'importe quel schéma de données, pas uniquement OpenTelemetry (OTel). Il convient donc aux pipelines d'observabilité personnalisés déjà construits sur ClickHouse.

Pour activer l'ensemble des fonctionnalités, vous devez fournir une instance MongoDB pour stocker l'état de l'application, notamment les tableaux de bord, les recherches enregistrées, les paramètres utilisateur et les alertes.

Dans ce mode, l'ingestion des données est entièrement à la charge de l'utilisateur. Vous pouvez ingérer des données dans ClickHouse à l'aide de votre propre collecteur OpenTelemetry hébergé, d'une ingestion directe depuis des bibliothèques client, des moteurs de table natifs de ClickHouse (tels que Kafka ou S3), de pipelines ETL ou de services d'ingestion gérés comme ClickPipes. Cette approche offre une flexibilité maximale et convient aux équipes qui exploitent déjà ClickHouse et souhaitent y ajouter HyperDX pour la visualisation, la recherche et les alertes.

<div id="suitable-for">
  ### Convient à
</div>

* Utilisateurs existants de ClickHouse
* Pipelines d’événements personnalisés

<div id="deployment-steps">
  ## Étapes de déploiement
</div>

<br />

<Steps>
  <Step>
    ### Déployer avec Docker

    Exécutez la commande suivante en remplaçant `YOUR_MONGODB_URI` selon vos besoins.

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

  <Step>
    ### Accéder à l'interface HyperDX

    Accédez à [http://localhost:8080](http://localhost:8080) pour ouvrir l'interface HyperDX.

    Créez un utilisateur en renseignant un nom d'utilisateur et un mot de passe conformes aux exigences.

    Après avoir cliqué sur `Create`, vous serez invité à renseigner les informations de connexion.

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

  <Step>
    ### Renseigner les informations de connexion

    Connectez-vous à votre propre cluster ClickHouse externe, par exemple ClickHouse Cloud.

    <Image img="https://mintcdn.com/private-7c7dfe99-mintlify-8c05c8a2/RhEK5rhPj_7m6pWY/images/use-cases/observability/hyperdx-2.png?fit=max&auto=format&n=RhEK5rhPj_7m6pWY&q=85&s=90882c718a44526d13c819ab7218a9d0" alt="Connexion HyperDX" size="md" width="1966" height="1392" data-path="images/use-cases/observability/hyperdx-2.png" />

    Si vous êtes invité à créer une source, conservez toutes les valeurs par défaut et renseignez le champ `Table` avec la valeur `otel_logs`. Tous les autres paramètres devraient être détectés automatiquement, ce qui vous permettra de cliquer sur `Save New Source`.

    <Info>
      **Création d'une source**

      La création d'une source nécessite l'existence de tables dans ClickHouse. Si vous n'avez pas de données, nous vous recommandons de déployer le ClickStack OpenTelemetry collector pour créer les tables.
    </Info>
  </Step>
</Steps>

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

Vous pouvez modifier la [configuration Docker Compose](/fr/clickstack/deployment/docker-compose) pour obtenir le même résultat que dans ce guide, en supprimant l’OTel collector et l’instance ClickHouse du manifest.

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

Même si vous gérez votre propre collecteur OpenTelemetry, indépendamment des autres composants de la stack, nous vous recommandons d'utiliser la distribution ClickStack du collector. Cela garantit l'utilisation du schéma par défaut et l'application des bonnes pratiques d'ingestion.

Pour plus de détails sur le déploiement et la configuration d'un collector autonome, consultez ["Ingestion avec OpenTelemetry"](/fr/clickstack/ingesting-data/collector#modifying-otel-collector-configuration).

<div id="schema-choice-map-vs-json">
  ## Choix du schéma : Map vs JSON
</div>

Par défaut, ClickStack stocke les attributs dans des colonnes `Map(LowCardinality(String), String)`. Il s’agit du schéma recommandé pour les charges de travail d’observabilité. Associé à la [sérialisation de map compartimentée](/fr/reference/data-types/map#bucketed-map-serialization) et à des index textuels sur les clés et les valeurs de la map, il permet des recherches sélectives sans la surcharge d’ingestion par clé propre aux sous-colonnes JSON dynamiques.

Un schéma de type `JSON` est disponible en bêta pour évaluation sur des charges de travail avec un ensemble réduit et stable de clés d’attributs. Il n’est **pas recommandé** par défaut. Consultez [Map vs JSON type](/fr/clickstack/ingesting-data/schema/map-vs-json) pour la comparaison complète et les variables d’environnement requises pour activer la prise en charge de JSON.