> ## Documentation Index > Fetch the complete documentation index at: https://private-7c7dfe99-trino-dialect.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Opciones de configuración > Opciones de configuración para ClickStack - la pila de observabilidad de ClickHouse export const Image = ({img, alt, size = "lg"}) => { const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg"; return
{alt}
; }; Las siguientes opciones de configuración están disponibles para cada componente de ClickStack:
## Configuración para distribuciones de código abierto
### Docker
Si usas [Todo en uno](/es/clickstack/deployment/all-in-one), [Solo HyperDX](/es/clickstack/deployment/hyperdx-only) o [Modo local](/es/clickstack/deployment/local-mode-only), solo tienes que pasar la configuración deseada mediante una variable de entorno; por ejemplo: ```shell theme={null} docker run -e HYPERDX_LOG_LEVEL='debug' -p 8080:8080 -p 4317:4317 -p 4318:4318 clickhouse/clickstack-all-in-one:latest ```
### Docker Compose
Si utiliza la guía de implementación de [Docker Compose](/es/clickstack/deployment/docker-compose), puede usar el archivo [`.env`](https://github.com/hyperdxio/hyperdx/blob/main/.env) para modificar la configuración. Como alternativa, sobrescriba explícitamente la configuración en el archivo [`docker-compose.yaml`](https://github.com/hyperdxio/hyperdx/blob/main/docker-compose.yml); por ejemplo: Ejemplo: ```yaml theme={null} services: app: environment: HYPERDX_API_KEY: ${HYPERDX_API_KEY} HYPERDX_LOG_LEVEL: ${HYPERDX_LOG_LEVEL} # ... otras configuraciones ```
### Helm
#### Personalización de los valores (opcional)
Puede personalizar la configuración con los indicadores `--set`, por ejemplo. ```shell theme={null} helm install my-hyperdx hyperdx/hdx-oss-v2 \ --set replicaCount=2 \ --set resources.limits.cpu=500m \ --set resources.limits.memory=512Mi \ --set resources.requests.cpu=250m \ --set resources.requests.memory=256Mi \ --set ingress.enabled=true \ --set ingress.annotations."kubernetes\.io/ingress\.class"=nginx \ --set ingress.hosts[0].host=hyperdx.example.com \ --set ingress.hosts[0].paths[0].path=/ \ --set ingress.hosts[0].paths[0].pathType=ImplementationSpecific \ --set env[0].name=CLICKHOUSE_USER \ --set env[0].value=abc ``` Como alternativa, edita el `values.yaml`. Para obtener los valores predeterminados: ```shell theme={null} helm show values hyperdx/hdx-oss-v2 > values.yaml ``` Configuración de ejemplo: ```yaml theme={null} replicaCount: 2 resources: limits: cpu: 500m memory: 512Mi requests: cpu: 250m memory: 256Mi ingress: enabled: true annotations: kubernetes.io/ingress.class: nginx hosts: - host: hyperdx.example.com paths: - path: / pathType: ImplementationSpecific env: - name: CLICKHOUSE_USER value: abc ```
## Aplicación ClickStack UI (HyperDX)
### Configuración de las fuentes de datos
La UI de ClickStack requiere que el usuario defina una fuente para cada uno de los tipos o pilares de datos de observabilidad: * `Logs` * `Traces` * `Metrics` * `Sessions` Esta configuración puede realizarse dentro de la aplicación desde `Team Settings -> Sources`, como se muestra a continuación para los logs: Configuración de fuente en HyperDX Cada una de estas fuentes requiere que se especifique al menos una tabla al crearla, así como un conjunto de columnas que permitan a HyperDX consultar los datos. Si se utiliza el [esquema predeterminado de OpenTelemetry (OTel)](/es/guides/use-cases/observability/build-your-own/integrating-opentelemetry#out-of-the-box-schema) incluido con ClickStack, estas columnas pueden inferirse automáticamente para cada una de las fuentes. Si se [modifica el esquema](#clickhouse) o se usa un esquema personalizado, los usuarios deben especificar y actualizar estas asignaciones. El esquema predeterminado de ClickHouse incluido con ClickStack es el esquema creado por el [exporter de ClickHouse para el OTel collector](https://github.com/open-telemetry/opentelemetry-collector-contrib/tree/main/exporter/clickhouseexporter). Estos nombres de columnas se corresponden con la especificación oficial de OTel documentada [aquí](https://opentelemetry.io/docs/specs/otel/logs/data-model/). La siguiente configuración está disponible para cada fuente:
#### Logs
| Configuración | Descripción | Obligatorio | Inferido en el esquema predeterminado | Valor inferido | | ------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------- | -------------------------------------------------- | | `Nombre` | Nombre de la fuente. | Sí | No | – | | `Sección` | Etiqueta opcional para agrupar fuentes en el selector de fuentes. Las fuentes que comparten una sección aparecen juntas, y la búsqueda también encuentra coincidencias con el nombre de la sección, además de con el nombre de la fuente. | No | No | – | | `Server Connection` | Nombre de la conexión del servidor. | Sí | No | `Predeterminado` | | `Base de datos` | Nombre de la base de datos de ClickHouse. | Sí | Sí | `default` | | `Tabla` | Nombre de la tabla de destino. Establézcalo en `otel_logs` si se utiliza el esquema predeterminado. | Sí | No | | | `Ajustes de consulta` | [Configuraciones de sesión](/es/reference/settings/session-settings) a nivel de consulta, cada una especificada mediante un nombre de configuración y un valor, que se aplican a cada consulta realizada en esta fuente. | No | No | – | | `Habilitado` | Una fuente deshabilitada se conserva, pero se oculta de los selectores de fuentes y nunca se selecciona automáticamente. | No | No | Habilitado | | `Columna de marca de tiempo` | Columna o expresión DateTime que forma parte de la clave primaria. | Sí | Sí | `TimestampTime` | | `Selección predeterminada` | Columnas que se muestran en los resultados de búsqueda predeterminados. | Sí | Sí | `Timestamp`, `ServiceName`, `SeverityText`, `Body` | | `Expresión del nombre del servicio` | Expresión o columna para el nombre del servicio. | Sí | Sí | `ServiceName` | | `Expresión de nivel de registro` | Expresión o columna para el nivel de registro. | Sí | Sí | `SeverityText` | | `Expresión del cuerpo` | Expresión o columna para el mensaje de registro. | Sí | Sí | `Body` | | `Expresión de atributos del registro` | Expresión o columna para atributos de registros personalizados. | Sí | Sí | `LogAttributes` | | `Expresión de atributos de recurso` | Expresión o columna para atributos a nivel de recurso. | Sí | Yes | `ResourceAttributes` | | `Columna de marca de tiempo que se muestra` | Columna de marca de tiempo opcional y de mayor precisión, utilizada para mostrar datos en la UI. Si no se proporciona, se usa de forma predeterminada Timestamp Column. | No | Yes | `Timestamp` | | `Fuente de métricas correlacionada` | Fuente de métricas vinculada (p. ej., métricas de HyperDX). | No | No | – | | `Fuente de trazas correlacionada` | Fuente de trazas vinculada (p. ej., trazas de HyperDX). | No | No | – | | `Expresión del ID de traza` | Expresión o columna utilizada para extraer el ID de la traza. | Sí | Sí | `TraceId` | | `Expresión de ID de span` | Expresión o columna utilizada para extraer el ID del span. | Sí | Sí | `SpanId` | | `Expresión de columna implícita` | Columna utilizada para la búsqueda de texto completo si no se especifica ningún campo (al estilo de Lucene). Normalmente, el cuerpo del registro. | Sí | Sí | `Body` | | `Lista de columnas conocidas` | Para fuentes basadas en una tabla [`Distributed`](/es/reference/engines/table-engines/special/distributed) o [`Merge`](/es/reference/engines/table-engines/special/merge) cuyas tablas de destino tienen conjuntos de columnas diferentes. Lista separada por comas de las columnas disponibles en todas las tablas de destino, que se utiliza en lugar de `SELECT *` al recuperar datos completos de una fila (por ejemplo, en el panel lateral de la fila). Déjelo en blanco para seleccionar todas las columnas. Solo nombres de columnas; no se admiten expresiones ni alias. | No | No | – | | `Usar índice de texto` | Indica si las búsquedas basadas en Lucene emiten `hasAllTokens` al buscar en la columna implícita. | No | No | `Automático (detectar según el esquema)` | | `Atributos destacados` | Expresiones o columnas que se muestran al abrir los detalles del registro. Las expresiones que devuelven URL se mostrarán como enlaces. | No | No | – | | `Atributos destacados de las trazas` | Expresiones o columnas extraídas de cada registro de una traza, mostradas encima del waterfall de la traza. Las expresiones que devuelven URL se mostrarán como enlaces. | No | No | – | | `Vistas materializadas` | [vistas materializadas](/es/clickstack/managing/materialized-views) preagregadas registradas para esta fuente, que se utilizan automáticamente para acelerar las consultas compatibles. Consulte [Vistas materializadas](#materialized-views-settings). | No | No | – | | `Vistas materializadas de metadatos` | Vistas materializadas que se utilizan para acelerar la detección de campos y el autocompletado de valores. Consulte [Vistas materializadas de metadatos](#metadata-materialized-views-settings). | No | Sí | `_kv_rollup_15m` | | `ORDER BY predeterminado` | Expresión `ORDER BY` que sobrescribe la ordenación predeterminada de los resultados de búsqueda. Déjelo vacío para usar la opción predeterminada detectada automáticamente. Puede personalizarse más adelante para cada búsqueda. | No | No | – |
#### Trazas
| Configuración | Descripción | Requerido | Inferido en el esquema predeterminado | Valor inferido | | -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------- | ------------------------------------- | ----------------------------------------------------------------------------------------------------- | | `Name` | Nombre de la fuente. | Sí | No | – | | `Section` | Etiqueta opcional para agrupar fuentes en el selector de fuentes. Las fuentes que comparten una sección aparecen juntas, y la búsqueda coincide con el nombre de la sección además del nombre de la fuente. | No | No | – | | `Server Connection` | Nombre de la conexión al servidor. | Sí | No | `Default` | | `Database` | Nombre de la base de datos de ClickHouse. | Sí | Sí | `default` | | `Table` | Nombre de la tabla de destino. Establécelo en `otel_traces` si usas el esquema predeterminado. | Sí | Sí | - | | `Query Settings` | [Configuraciones de sesión](/es/reference/settings/session-settings) a nivel de consulta, cada una indicada como un nombre de configuración y un valor, que se agregan a cada consulta emitida contra esta fuente. | No | No | – | | `Enabled` | Una fuente deshabilitada se conserva, pero se oculta de los selectores de fuentes y nunca se elige automáticamente. | No | No | Habilitado | | `Timestamp Column` | Columna de fecha y hora o expresión que forma parte de la clave primaria. | Sí | Sí | `Timestamp` | | `Default Select` | Columnas que se muestran en los resultados de búsqueda predeterminados. | Sí | Sí | `Timestamp, ServiceName as service, StatusCode as level, round(Duration / 1e6) as duration, SpanName` | | `Duration Expression` | Expresión para calcular la duración del span. | Sí | Sí | `Duration` | | `Duration Precision` | Precisión de la expresión de duración (p. ej., nanosegundos, microsegundos). | Sí | Sí | ns | | `Trace Id Expression` | Expresión o columna para los ID de traza. | Sí | Sí | `TraceId` | | `Span Id Expression` | Expresión o columna para los ID de span. | Sí | Sí | `SpanId` | | `Parent Span Id Expression` | Expresión o columna para los ID del span padre. | Sí | Sí | `ParentSpanId` | | `Span Name Expression` | Expresión o columna para los nombres de span. | Sí | Sí | `SpanName` | | `Span Kind Expression` | Expresión o columna para el tipo de span (p. ej., cliente, servidor). | Sí | Sí | `SpanKind` | | `Correlated Log Source` | Opcional. Fuente de logs correlacionada (p. ej., logs de HyperDX). | No | No | – | | `Correlated Session Source` | Opcional. Fuente de sesión correlacionada. | No | No | – | | `Correlated Metric Source` | Opcional. Fuente de métricas correlacionada (p. ej., métricas de HyperDX). | No | No | – | | `Status Code Expression` | Expresión para el código de estado del span. | Sí | Sí | `StatusCode` | | `Status Message Expression` | Expresión para el mensaje de estado del span. | Sí | Sí | `StatusMessage` | | `Service Name Expression` | Expresión o columna para el nombre del servicio. | Sí | Sí | `ServiceName` | | `Resource Attributes Expression` | Expresión o columna para los atributos a nivel de recurso. | Sí | Sí | `ResourceAttributes` | | `Event Attributes Expression` | Expresión o columna para los atributos del evento. | Sí | Sí | `SpanAttributes` | | `Sample Rate Expression` | Columna o expresión que contiene el peso de muestreo de origen (`1/N`). Cuando se configura, las agregaciones (`count`, `avg`, `sum`, `quantile`) se corrigen según el muestreo. Los percentiles usan entonces `quantileTDigestWeighted`, que es una aproximación, por lo que los valores exactos pueden diferir ligeramente. Déjalo vacío si los spans no se muestrean. | No | No | – | | `Span Events Expression` | Expresión para extraer eventos del span. Normalmente, es una columna de tipo `Nested`. Esto permite mostrar trazas de pila de excepciones con SDKs de lenguaje compatibles. | Sí | Sí | `Events` | | `Span Links Expression` | Expresión para extraer enlaces de span, usada para capturar enlaces desde un span a spans de otras trazas. Se espera que sea de tipo `Nested(TraceId String, SpanId String, TraceState String, Attributes Map(LowCardinality(String), String))`. | No | Sí | `Links` | | `Implicit Column Expression` | Columna usada para la búsqueda de texto completo si no se especifica ningún campo (estilo Lucene). Normalmente, el cuerpo del log. | Sí | Sí | `SpanName` | | `Known Columns List` | Para fuentes sobre una tabla [`Distributed`](/es/reference/engines/table-engines/special/distributed) o [`Merge`](/es/reference/engines/table-engines/special/merge) cuyas tablas de destino tienen conjuntos de columnas que no coinciden. Una lista separada por comas de las columnas disponibles en todas las tablas de destino, usada en lugar de `SELECT *` al obtener datos de filas completos (por ejemplo, en el panel lateral de filas). Déjala en blanco para seleccionar todas las columnas. Solo nombres de columnas, sin expresiones ni alias. | No | No | – | | `Use Text Index` | Indica si las búsquedas basadas en Lucene emiten `hasAllTokens` al buscar en la columna implícita. | No | No | `Auto (detect from schema)` | | `Displayed Timestamp Column` | Columna de marca de tiempo opcional y de mayor precisión usada en la visualización de la UI. De forma predeterminada, se usa Timestamp Column cuando no se proporciona. | No | Sí | `Timestamp` | | `Highlighted Attributes` | Expresiones o columnas que se muestran al abrir los detalles del span. Las expresiones que devuelven URL se mostrarán como enlaces. | No | No | – | | `Highlighted Trace Attributes` | Expresiones o columnas extraídas de cada span de una traza, que se muestran encima del waterfall de la traza. Las expresiones que devuelven URL se mostrarán como enlaces. | No | No | – | | `Materialized Views` | [Vistas materializadas](/es/clickstack/managing/materialized-views) preagregadas registradas para esta fuente, que se usan automáticamente para acelerar las consultas aptas. Consulta [Vistas materializadas](#materialized-views-settings). | No | No | – | | `Metadata Materialized Views` | Vistas materializadas usadas para acelerar la detección de campos y el autocompletado de valores. Consulta [Vistas materializadas de metadatos](#metadata-materialized-views-settings). | No | Sí | `
_kv_rollup_15m` | | `Default Order By` | Expresión `ORDER BY` que sobrescribe el orden predeterminado de los resultados de búsqueda. Déjalo vacío para usar el valor predeterminado detectado automáticamente. Esto se puede personalizar posteriormente para cada búsqueda. | No | No | – |
#### Métricas
| SETTING | Descripción | Obligatorio | Inferido en el esquema predeterminado | Valor inferido | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------- | ------------------------------------ | | `Name` | Nombre de la fuente. | Sí | No | – | | `Section` | Etiqueta opcional para agrupar fuentes en el selector de fuentes. Las fuentes que comparten una sección aparecen juntas, y la búsqueda coincide con el nombre de la sección además de con el nombre de la fuente. | No | No | – | | `Server Connection` | Nombre de la conexión al servidor. | Sí | No | `Default` | | `Database` | Nombre de la base de datos de ClickHouse. | Sí | Sí | `default` | | `Query Settings` | Hasta diez [SETTINGS de sesión](/es/reference/settings/session-settings) a nivel de consulta, cada uno indicado como un nombre de ajuste y un valor, que se agregan a cada consulta emitida contra esta fuente. | No | No | – | | `Enabled` | Interruptor en la parte superior del formulario de la fuente. Una fuente deshabilitada se conserva, pero se oculta de los selectores de fuentes y nunca se elige automáticamente. Solo se muestra al editar una fuente existente. | No | No | Habilitado | | `Gauge Table` | Tabla que almacena métricas de tipo gauge. | No | Sí | `otel_metrics_gauge` | | `Histogram Table` | Tabla que almacena métricas de tipo histograma. | No | Sí | `otel_metrics_histogram` | | `Sum Table` | Tabla que almacena métricas de tipo suma (counter). | No | Sí | `otel_metrics_sum` | | `Exponential Histogram Table` | Tabla que almacena métricas de tipo histograma exponencial. | No | Sí | `otel_metrics_exponential_histogram` | | `Correlated Log Source` | Opcional. Fuente de logs correlacionada (p. ej., logs de HyperDX). | No | No | – |
#### Sesiones
| SETTING | Descripción | Obligatorio | Inferido en el esquema predeterminado | Valor inferido | | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- | ------------------------------------- | -------------------- | | `Name` | Nombre de la fuente. | Sí | No | – | | `Section` | Etiqueta opcional para agrupar fuentes en el selector de fuentes. Las fuentes que comparten una sección aparecen juntas, y la búsqueda también coincide con el nombre de la sección, además del nombre de la fuente. | No | No | – | | `Server Connection` | Nombre de la conexión al servidor. | Sí | No | `Default` | | `Database` | Nombre de la base de datos de ClickHouse. | Sí | Sí | `default` | | `Table` | Tabla de destino para los datos de sesión. Nombre de la tabla de destino. Establézcala en `hyperdx_sessions` si usa el esquema predeterminado. | Sí | Sí | - | | `Query Settings` | Hasta diez [SETTINGS de sesión](/es/reference/settings/session-settings) a nivel de consulta, cada uno indicado como un nombre de ajuste y un valor, que se agregan a cada consulta emitida contra esta fuente. | No | No | – | | `Enabled` | Interruptor en la parte superior del formulario de la fuente. Una fuente deshabilitada se conserva, pero se oculta de los selectores de fuentes y nunca se elige automáticamente. Solo se muestra al editar una fuente existente. | No | No | Habilitado | | `Correlated Trace Source` | Fuente de trazas correlacionada para correlacionar sesiones. | Sí | No | – | | `Timestamp Column` | Columna de fecha y hora o expresión que forma parte de su clave primaria. | Sí | Sí | `TimestampTime` | | `Resource Attributes Expression` | Expresión para extraer metadatos a nivel de recurso. | No | Sí | `ResourceAttributes` |
#### Vistas materializadas
Las vistas materializadas se pueden registrar para las fuentes de datos de Log y traza, de modo que las consultas de agregación aptas se resuelvan a partir de la vista preagregada en lugar de la tabla de origen. Para obtener instrucciones sobre cómo crear y registrar vistas, consulte ["Vistas materializadas"](/es/clickstack/managing/materialized-views). Cada vista registrada se configura con los siguientes SETTINGS: | SETTING | Descripción | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `Database` | Base de datos de ClickHouse que contiene la tabla de destino de la vista materializada. | | `Table` | Tabla de destino de la vista materializada, no la vista en sí. | | `Timestamp Column` | Columna de marca de tiempo de la tabla de destino. | | `Granularity` | Intervalo de tiempo de la columna de marca de tiempo de la tabla de destino; por ejemplo, `1 minute`. Una consulta solo puede usar la vista si su propio intervalo de tiempo es igual o menos granular que este. | | `Minimum Date` | Opcional. La fecha y hora más tempranas para las que la vista contiene datos. Si no se proporciona, ClickStack asume que la vista contiene datos para todas las fechas presentes en la tabla de origen. | | `Dimension Columns` | Lista, separada por comas, de las columnas que la vista no preagrega y que, por lo tanto, se pueden usar para filtrar y agrupar. | | `Pre-aggregated Columns` | Columnas que la vista preagrega. Cada entrada asigna una función de agregación (`avg`, `count`, `max`, `min`, `quantile`, `sum` o `histogram`) y una columna de la tabla de origen a la columna correspondiente de la vista. La columna de origen no es necesaria para `count`. | La mayoría de estos SETTINGS se infieren del esquema de la vista al seleccionar la tabla de destino.
#### Vistas materializadas de metadatos
Las vistas materializadas de metadatos aceleran la detección de campos para los filtros y el autocompletado. Se pueden configurar en fuentes de datos de log y trazas. | SETTING | Descripción | | ------------------ | ------------------------------------------------------------------------------------- | | `Key Rollup Table` | Opcional y obsoleta. Tabla de agregación de las claves presentes en la tabla fuente. | | `KV Rollup Table` | Tabla de agregación de los pares clave/valor presentes en la tabla fuente. | | `Granularity` | Intervalo de tiempo utilizado por las tablas de agregación, por ejemplo, `15 minute`. |
#### Atributos destacados
Los Atributos destacados y los Atributos de traza destacados se pueden configurar en las fuentes de datos de Log y traza. * Los Atributos destacados son columnas o expresiones que se muestran para cada log o span al ver los detalles del log o del span. * Los Atributos de traza destacados son columnas o expresiones que se consultan de cada log o span de una traza y se muestran sobre el waterfall de la traza. Estos atributos se definen en la configuración de la fuente y pueden ser expresiones SQL arbitrarias. Si la expresión SQL devuelve un valor con formato de URL, el atributo se mostrará como un enlace. Los valores vacíos no se muestran. Cada atributo se configura con las siguientes opciones: | SETTING | Descripción | | ------------------- | --------------------------------------------------------------------------------------------- | | `SQL Expression` | La columna o expresión SQL arbitraria que se debe consultar. Obligatorio. | | `Alias` | Opcional. La etiqueta que se muestra para el atributo en lugar de la expresión SQL. | | `Lucene Expression` | Opcional. Una versión Lucene de la expresión SQL, utilizada al buscar este valor de atributo. | Por ejemplo, esta fuente de trazas se ha configurado con un Atributo destacado y un Atributo de traza destacado: Estos atributos se muestran en el panel lateral después de hacer clic en un log o span: Al hacer clic en un atributo, se ofrecen opciones para usarlo como valor de búsqueda. Si se proporciona la expresión Lucene opcional en la configuración del atributo, se utilizará la expresión Lucene para la búsqueda en lugar de la expresión SQL.
### Fuentes correlacionadas
Para habilitar la correlación completa entre fuentes en ClickStack, debe configurar fuentes correlacionadas para logs, trazas, métricas y sesiones. Esto permite que HyperDX asocie datos relacionados y proporcione un contexto enriquecido al mostrar eventos. * `Logs`: Se pueden correlacionar con trazas y métricas. * `Traces`: Se pueden correlacionar con logs, sesiones y métricas. * `Metrics`: Se pueden correlacionar con logs. * `Sessions`: Se pueden correlacionar con trazas. Configurar estas correlaciones habilita varias funcionalidades. Por ejemplo, HyperDX puede mostrar logs relevantes junto a una traza o resaltar anomalías de métricas vinculadas a una sesión. Por ejemplo, a continuación se muestra la fuente de logs configurada con fuentes correlacionadas:
### Opciones de configuración de la aplicación
**HyperDX en ClickHouse Cloud** Estas opciones no se pueden modificar cuando HyperDX se gestiona en ClickHouse Cloud. * `HYPERDX_API_KEY` * **Predeterminado:** Ninguno (obligatorio) * **Descripción:** Clave de autenticación para la API de HyperDX. * **Orientación:** * Obligatoria para telemetría y logging * En el desarrollo local, puede ser cualquier valor no vacío * Para producción, use una clave segura y única * Puede obtenerse en la página de configuración del equipo después de crear la cuenta * `HYPERDX_LOG_LEVEL` * **Predeterminado:** `info` * **Descripción:** Establece el nivel de detalle del registro. * **Opciones:** `debug`, `info`, `warn`, `error` * **Guía:** * Use `debug` para la solución detallada de problemas * Use `info` para el funcionamiento normal * Use `warn` o `error` en producción para reducir el volumen de logs * `HYPERDX_API_PORT` * **Predeterminado:** `8000` * **Descripción:** Puerto del servidor de la API de HyperDX. * **Guía:** * Asegúrese de que este puerto esté disponible en el host * Cámbielo si hay conflictos de puertos * Debe coincidir con el puerto de las configuraciones del cliente de la API * `HYPERDX_APP_PORT` * **Valor predeterminado:** `8000` * **Descripción:** Puerto de la aplicación frontend de HyperDX. * **Recomendaciones:** * Asegúrate de que este puerto esté disponible en el host * Cámbialo si hay conflictos de puertos * Debe ser accesible desde el navegador * `HYPERDX_APP_URL` * **Predeterminado:** `http://localhost` * **Descripción:** URL base de la aplicación frontend. * **Guía:** * En producción, configúralo con tu dominio * Incluye el protocolo (http/https) * No incluyas la barra final * `MONGO_URI` * **Predeterminado:** `mongodb://db:27017/hyperdx` * **Descripción:** cadena de conexión de MongoDB. * **Guía:** * Use el valor predeterminado para el desarrollo local con Docker * Para producción, use una cadena de conexión segura * Incluya autenticación si es necesario * Ejemplo: `mongodb://user:pass@host:port/db` * `MINER_API_URL` * **Predeterminado:** `http://miner:5123` * **Descripción:** URL del servicio de minería de patrones de logs. * **Guía:** * Usa el valor predeterminado para el desarrollo local con Docker * Configúralo con la URL de tu servicio de miner en producción * Debe ser accesible desde el servicio de la API * `FRONTEND_URL` * **Predeterminado:** `http://localhost:3000` * **Descripción:** URL de la aplicación frontend. * **Orientación:** * Use el valor predeterminado para el desarrollo local * Establézcalo con su dominio en producción * Debe ser accesible desde el servicio API * `OTEL_SERVICE_NAME` * **Predeterminado:** `hdx-oss-api` * **Descripción:** Nombre del servicio para la instrumentación de OpenTelemetry. * **Indicaciones:** * Use un nombre descriptivo para su servicio de HyperDX. Se aplica si HyperDX se instrumenta automáticamente. * Ayuda a identificar el servicio de HyperDX en los datos de telemetría * `NEXT_PUBLIC_OTEL_EXPORTER_OTLP_ENDPOINT` * **Predeterminado:** `http://localhost:4318` * **Descripción:** endpoint del collector de OpenTelemetry. * **Indicaciones:** * Relevante para la autoinstrumentación de HyperDX. * Use el valor predeterminado para el desarrollo local * Configúrelo con la URL de su collector en producción * Debe ser accesible desde su servicio de HyperDX * `USAGE_STATS_ENABLED` * **Predeterminado:** `true` * **Descripción:** Activa o desactiva la recopilación de estadísticas de uso. * **Orientación:** * Establézcalo en `false` para desactivar el seguimiento de uso * Útil para implementaciones con requisitos estrictos de privacidad * El valor predeterminado es `true` para facilitar la mejora del producto * `IS_OSS` * **Predeterminado:** `true` * **Descripción:** Indica si se ejecuta en modo OSS. * **Recomendaciones:** * Manténgalo como `true` para implementaciones de código abierto * Establézcalo en `false` para implementaciones empresariales * Afecta a la disponibilidad de funciones * `IS_LOCAL_MODE` * **Valor predeterminado:** `false` * **Descripción:** Indica si se ejecuta en modo local. * **Recomendaciones:** * Establézcalo en `true` para el desarrollo local * Desactiva determinadas funciones de producción * Útil para pruebas y desarrollo * `EXPRESS_SESSION_SECRET` * **Predeterminado:** `hyperdx is cool 👋` * **Descripción:** Secreto para la gestión de sesiones de Express. * **Recomendaciones:** * Cámbielo en producción * Use una cadena segura y aleatoria * Manténgalo en secreto y protegido * `ENABLE_SWAGGER` * **Valor predeterminado:** `false` * **Descripción:** Activa o desactiva la documentación de la API de Swagger. * **Recomendaciones:** * Establézcalo en `true` para habilitar la documentación de la API * Útil para desarrollo y pruebas * Desactívelo en producción * `BETA_CH_OTEL_JSON_SCHEMA_ENABLED` * **Predeterminado:** `false` * **Descripción:** Habilita la compatibilidad beta con el tipo JSON en HyperDX. Consulta también [`OTEL_AGENT_FEATURE_GATE_ARG`](#otel-collector) para habilitar la compatibilidad con JSON en el OTel collector. * **Guía:** * Habilita una **funcionalidad beta**. Los esquemas con tipo JSON **no se recomiendan** para las cargas de trabajo de observabilidad habituales. Consulta [Map vs JSON type](/es/clickstack/ingesting-data/schema/map-vs-json) para ver la comparación y cuándo conviene usar cada uno. * Establécelo en `true` para habilitar la compatibilidad con JSON en la UI de ClickStack.
## OpenTelemetry collector
Consulta ["ClickStack OpenTelemetry Collector"](/es/clickstack/ingesting-data/collector) para obtener más información. * `CLICKHOUSE_ENDPOINT` * **Predeterminado:** *Ninguno (obligatorio)* si se usa una imagen independiente. Si se usa una distribución All-in-one o Docker Compose, se establece en la instancia integrada de ClickHouse. * **Descripción:** La URL HTTPS de la instancia de ClickHouse a la que se exportarán los datos de telemetría. * **Guía:** * Debe ser un endpoint HTTPS completo, incluido el puerto (p. ej., `https://clickhouse.example.com:8443`) * Es obligatorio para que el collector envíe datos a ClickHouse * `CLICKHOUSE_USER` * **Predeterminado:** `default` * **Descripción:** Nombre de usuario utilizado para autenticarse con la instancia de ClickHouse. * **Guía:** * Asegúrate de que el usuario tenga permisos de `INSERT` y `CREATE TABLE` * Se recomienda crear un usuario dedicado para la ingestión * `CLICKHOUSE_PASSWORD` * **Predeterminado:** *Ninguno (obligatorio si la autenticación está habilitada)* * **Descripción:** Contraseña del usuario de ClickHouse especificado. * **Guía:** * Es obligatorio si la cuenta de usuario tiene una contraseña configurada * Almacénala de forma segura mediante secretos en implementaciones de producción * `HYPERDX_LOG_LEVEL` * **Predeterminado:** `info` * **Descripción:** Nivel de verbosidad de los logs del collector. * **Guía:** * Acepta valores como `debug`, `info`, `warn`, `error` * Usa `debug` durante la resolución de problemas * `OPAMP_SERVER_URL` * **Predeterminado:** *Ninguno (obligatorio)* si se usa una imagen independiente. Si se usa una distribución All-in-one o Docker Compose, apunta a la instancia de HyperDX desplegada. * **Descripción:** URL del servidor OpAMP utilizado para gestionar el collector (p. ej., una instancia de HyperDX). De forma predeterminada, usa el puerto `4320`. * **Guía:** * Debe apuntar a tu instancia de HyperDX * Habilita la configuración dinámica y la ingestión segura * Si se omite, la ingestión segura se desactiva a menos que se especifique un valor para `OTLP_AUTH_TOKEN`. * `OTLP_AUTH_TOKEN` * **Predeterminado:** *Ninguno*. Solo se usa para la imagen independiente. * **Descripción:** Permite especificar un token de autenticación OTLP. Si se configura, toda la comunicación requiere este token Bearer. * **Guía:** * Se recomienda si usas la imagen independiente del collector en producción. * `HYPERDX_OTEL_EXPORTER_CLICKHOUSE_DATABASE` * **Predeterminado:** `default` * **Descripción:** Base de datos de ClickHouse en la que el collector escribe los datos de telemetría. * **Guía:** * Establécelo si usas un nombre de base de datos personalizado * Asegúrate de que el usuario especificado tenga acceso a esta base de datos * `OTEL_AGENT_FEATURE_GATE_ARG` * **Predeterminado:** `` * **Descripción:** Habilita feature flags en el collector. Si se establece en `--feature-gates=clickhouse.json`, habilita la compatibilidad Beta con el tipo JSON en el collector, lo que garantiza que los esquemas se creen con ese tipo. Consulta también [`BETA_CH_OTEL_JSON_SCHEMA_ENABLED`](#hyperdx) para habilitar la compatibilidad con JSON en HyperDX. * **Guía:** * Habilita una **función beta**. Los esquemas con tipo JSON **no se recomiendan** para cargas de trabajo de observabilidad típicas. Consulta [Map vs JSON type](/es/clickstack/ingesting-data/schema/map-vs-json) para ver la comparación y cuándo es apropiado cada uno. * Establécelo en `--feature-gates=clickhouse.json` para crear tablas nuevas con el tipo JSON.
## ClickHouse
ClickStack Open Source incluye una configuración predeterminada de ClickHouse diseñada para escalar a varios terabytes, pero los usuarios pueden modificarla y optimizarla según su carga de trabajo. Para optimizar ClickHouse de forma eficaz, debe comprender conceptos clave de almacenamiento como las [partes](/es/concepts/core-concepts/parts), las [particiones](/es/concepts/core-concepts/partitions), los [segmentos y réplicas](/es/guides/oss/deployment-and-scaling/shards) y cómo se producen las [fusiones](/es/concepts/core-concepts/merges) durante la inserción. Recomendamos revisar los fundamentos de los [índices primarios](/es/concepts/core-concepts/primary-indexes), los [índices secundarios dispersos](/es/concepts/features/performance/skip-indexes/skipping-indexes) y los índices de omisión de datos, junto con técnicas para [gestionar el ciclo de vida de los datos](/es/guides/use-cases/observability/build-your-own/managing-data), por ejemplo, mediante TTL. ClickStack admite la [personalización del esquema](/es/guides/use-cases/observability/build-your-own/schema-design): puede modificar los tipos de las columnas, extraer nuevos campos (p. ej., de logs), aplicar codecs y diccionarios, y acelerar las consultas mediante proyecciones. Además, las vistas materializadas pueden utilizarse para [transformar o filtrar datos durante la ingestión](/es/guides/use-cases/observability/build-your-own/schema-design#materialized-columns), siempre que los datos se escriban en la tabla origen de la vista y la aplicación lea de la tabla de destino. Las vistas materializadas también pueden utilizarse para [acelerar consultas de forma nativa](/es/clickstack/managing/materialized-views) en ClickStack. Para obtener más información, consulte la documentación de ClickHouse sobre diseño de esquemas, estrategias de indexación y buenas prácticas para la gestión de datos; la mayoría se aplican directamente a las implementaciones de ClickStack.