> ## 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.
# Primeros pasos con ClickStack Open Source
> Ejecute ClickStack Open Source localmente, envíe datos de prueba y confirme que la ingestión funciona
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
Ejecute ClickStack Open Source de forma local, envíe un evento de prueba a través de su OpenTelemetry Collector y confirme que el evento está disponible en la UI de ClickStack.
Con ClickStack Open Source, puede ejecutar y administrar el backend de ClickHouse, la UI de ClickStack y el pipeline de ingestión. La imagen todo en uno incluye estos componentes junto con MongoDB en un único contenedor Docker para realizar evaluaciones y pruebas locales.
También está disponible una versión administrada de ClickStack; consulte [Managed ClickStack](/es/clickstack/getting-started/managed).
Los pasos siguientes utilizan la imagen todo en uno autenticada. Si desea una UI local sin crear una cuenta, siga la [guía del modo local con Docker](/es/clickstack/deployment/local-mode-only).
## Antes de empezar
Instala [Docker](https://docs.docker.com/get-docker/) y confirma que los siguientes puertos estén disponibles:
* `8080` para la UI de ClickStack
* `4317` para OTLP mediante gRPC
* `4318` para OTLP mediante HTTP
* `8123` para la interfaz HTTP de ClickHouse
Para cargas de trabajo sostenidas o en producción, consulta las [opciones de implementación de código abierto](/es/clickstack/deployment/oss) y [Pasar a producción](/es/clickstack/managing/production).
## Configura ClickStack Open Source con la imagen todo en uno
Ejecuta la imagen todo en uno:
```shell theme={null}
docker run \
--name clickstack \
-p 8123:8123 \
-p 8080:8080 \
-p 4317:4317 \
-p 4318:4318 \
clickhouse/clickstack-all-in-one:latest
```
El contenedor se ejecuta en primer plano. Deja esta terminal abierta y usa una segunda terminal para ejecutar los comandos restantes de esta guía.
Para conservar la configuración de ClickStack, los datos y los logs de ClickHouse después de eliminar el contenedor, ejecuta este comando en su lugar:
```shell theme={null}
docker run \
--name clickstack \
-p 8123:8123 \
-p 8080:8080 \
-p 4317:4317 \
-p 4318:4318 \
-v "$(pwd)/.volumes/db:/data/db" \
-v "$(pwd)/.volumes/ch_data:/var/lib/clickhouse" \
-v "$(pwd)/.volumes/ch_logs:/var/log/clickhouse-server" \
clickhouse/clickstack-all-in-one:latest
```
`$(pwd)` se resuelve como tu directorio actual. Este comando almacena los archivos persistentes en el directorio `.volumes` de esa ubicación.
Cuando ClickStack se inicie, abre [http://localhost:8080](http://localhost:8080) y crea una cuenta.
ClickStack se conecta automáticamente a la instancia de ClickHouse incluida y crea fuentes de datos para logs, trazas, métricas y sesiones.
#### Copia el API key de ingestión
En la sección **Primeros pasos** del menú izquierdo, selecciona **Agregar datos** y copia el **API key de ingestión**. La telemetría enviada al OpenTelemetry Collector incluido debe incluir esta clave en el header `authorization`.
En la segunda terminal, exporta el API key de ingestión:
```shell theme={null}
export CLICKSTACK_API_KEY=
```
Envía un log OTLP con la marca de tiempo actual:
```shell theme={null}
NOW_NANO="$(date +%s)000000000"
curl -i "http://localhost:4318/v1/logs" \
-H "Content-Type: application/json" \
-H "authorization: ${CLICKSTACK_API_KEY}" \
--data-binary @- <
Abre la vista **Búsqueda** en ClickStack y busca `ClickStack ingestion test`.
El resultado debería incluir el evento de prueba con el nombre de servicio `clickstack-docs-test`.
Ahora tienes una instancia local de ClickStack, un endpoint de ingestión operativo y un evento de prueba que puedes inspeccionar en ClickStack.
## Próximos pasos
### Envíe datos de aplicaciones e infraestructura
Elija una guía según los datos que desee enviar a ClickStack:
Envíe trazas y logs de aplicaciones con un SDK de OpenTelemetry compatible.
Reenvíe logs del host desde un OpenTelemetry Collector que se ejecuta con el rol de agente.
Recopile logs, métricas y trazas de un clúster de Kubernetes.
Encuentre guías para aplicaciones y fuentes de telemetría adicionales.
### Explorar datos de ejemplo
Use un conjunto de datos de ejemplo para explorar ClickStack con telemetría más completa:
Cargue datos de la demo pública y diagnostique un issue.
Recopile archivos locales y métricas del sistema en macOS o Linux.
Para explorar datos precargados sin instalar Docker, use la [demo alojada de ClickStack](/es/clickstack/example-datasets/remote-demo-data).
### Generar datos sintéticos
Use un generador para probar la ingestión sin necesidad de una aplicación o un conjunto de datos existentes:
Envíe una breve ráfaga de logs, trazas y métricas sintéticos mediante OTLP.
Genere señales configurables de OpenTelemetry en varios servicios.
Consulte [todos los datos de ejemplo y las demos de ClickStack](/es/clickstack/example-datasets/index).
### Preparación para producción
Revise las recomendaciones de implementación y producción antes de usar ClickStack con cargas de trabajo sostenidas:
Revise las credenciales de ingestión, la seguridad, la retención y las recomendaciones operativas.
Compare las opciones de implementación de código abierto para su entorno.