# Documentación de ghchronicle > Recoge todas las métricas que GitHub expone sobre una cuenta y las guarda con la fecha en que ocurrieron. Este es el índice del sitio de documentación de ghchronicle. Cada entrada enlaza una página y lleva la descripción de esa página. El código, las incidencias y las publicaciones están en https://github.com/jmrplens/ghchronicle. Portada: [ghchronicle](https://jmrplens.github.io/ghchronicle/es/): Recoge todas las métricas que GitHub expone sobre una cuenta y las guarda con la fecha en que ocurrieron. ## Empezar aquí - [Qué es](https://jmrplens.github.io/ghchronicle/es/start/): Qué recoge ghchronicle y el problema que viene a resolver. - [Inicio rápido](https://jmrplens.github.io/ghchronicle/es/start/quickstart/): De cero a la primera pasada, y qué hace esa primera pasada que las siguientes no hacen. - [El token](https://jmrplens.github.io/ghchronicle/es/start/token/): Qué familias compra cada permiso, y por qué el GITHUB_TOKEN automático no basta. ## Instalación - [Formas de instalar](https://jmrplens.github.io/ghchronicle/es/install/): Una página por sistema operativo, cuatro maneras de poner el binario en marcha, y para qué sirve cada una. - [Linux](https://jmrplens.github.io/ghchronicle/es/install/linux/): El camino completo en Linux: el archivo correcto, la firma, el PATH, un servicio y compilarlo tú mismo. - [macOS](https://jmrplens.github.io/ghchronicle/es/install/macos/): El camino completo en macOS: el archivo darwin, la cuarentena, un agente o demonio de launchd y compilarlo tú mismo. - [Windows](https://jmrplens.github.io/ghchronicle/es/install/windows/): El camino completo en Windows: el zip, PowerShell y cmd, una tarea programada y lo que de verdad cambia allí. - [systemd](https://jmrplens.github.io/ghchronicle/es/install/systemd/): Una unidad blindada para el único proceso de la máquina que guarda un token de GitHub, y para qué sirve cada restricción. - [Docker](https://jmrplens.github.io/ghchronicle/es/install/docker/): La imagen distroless, qué hay que montar con escritura y un compose junto a InfluxDB. - [GitHub Actions](https://jmrplens.github.io/ghchronicle/es/install/actions/): La Action compuesta, sus tres modos y las dos cosas que un runner alojado no conserva. ## Configuración - [El fichero](https://jmrplens.github.io/ghchronicle/es/configuration/): Un fichero YAML, todos los valores expandibles desde el entorno, y para qué sirve cada bloque de primer nivel. - [Generar la configuración](https://jmrplens.github.io/ghchronicle/es/configuration/builder/): Un formulario que escribe el config.yaml de una ejecución normal y el paso de workflow de la Action, a partir de la lista de ajustes del propio binario. - [Objetivos](https://jmrplens.github.io/ghchronicle/es/configuration/targets/): Qué repositorios toca una pasada, y por qué los forks y los archivados quedan fuera por omisión. - [Cadencias](https://jmrplens.github.io/ghchronicle/es/configuration/cadences/): Las tres capas del bloque every, la cadencia interna de cada familia, el aviso cuando una configuración la acelera, y el heartbeat. - [Registro](https://jmrplens.github.io/ghchronicle/es/configuration/logging/): Nivel, formato, el fichero rotatorio que nunca sustituye a la salida de error, y las dos líneas que merecen alerta. ## Cómo funciona - [La pasada](https://jmrplens.github.io/ghchronicle/es/how/): Qué hace un recorrido por GitHub, en qué orden, y por qué cada familia tiene su propia cadencia. - [La fecha del punto](https://jmrplens.github.io/ghchronicle/es/how/dating/): Cada punto lleva el momento en que ocurrió la cosa, y esa única regla decide qué puede responder todo el proyecto. - [Relleno histórico](https://jmrplens.github.io/ghchronicle/es/how/backfill/): Un recorrido deliberado hasta el final de cada superficie, hasta dónde llega, y las tres cosas que ningún relleno alcanza. ## Colectores - [Qué se recoge](https://jmrplens.github.io/ghchronicle/es/collectors/): Las treinta y cuatro familias, qué le pide cada una a GitHub y por qué existe cada una. - [Medidas](https://jmrplens.github.io/ghchronicle/es/collectors/measurements/): Cada medida, sus etiquetas, sus campos y cómo se fecha cada una. ## Destinos - [Elegir almacén](https://jmrplens.github.io/ghchronicle/es/sinks/): Diez almacenes, qué puede y qué no puede responder cada uno, y la propiedad que decide entre ellos. - [InfluxDB](https://jmrplens.github.io/ghchronicle/es/sinks/influxdb/): El almacén de referencia para la historia fechada, por qué volver a recoger converge, y el único error de escritura que conviene reconocer. - [Prometheus](https://jmrplens.github.io/ghchronicle/es/sinks/prometheus/): Un exportador, no un emisor, y qué le hace a cada medida la reducción a valores actuales. - [OpenTelemetry](https://jmrplens.github.io/ghchronicle/es/sinks/otlp/): OTLP sobre HTTP con codificación JSON, y por qué raw vale false por omisión. - [PostgreSQL](https://jmrplens.github.io/ghchronicle/es/sinks/postgres/): Sentencias INSERT que se pasan a psql, el esquema que declaran y por qué la cláusula de conflicto actualiza en vez de no hacer nada. - [Graphite](https://jmrplens.github.io/ghchronicle/es/sinks/graphite/): El protocolo de texto plano sobre TCP, y la ruta métrica exacta, que es el contrato del dashboard. - [Elasticsearch](https://jmrplens.github.io/ghchronicle/es/sinks/elasticsearch/): La API bulk, un índice por medida, y un id de documento que hace que una reescritura reemplace en vez de duplicar. - [Loki](https://jmrplens.github.io/ghchronicle/es/sinks/loki/): Las veintidós medidas que son eventos y no números, y el horizonte de antigüedad que evita que se rechace un envío. - [Telegraf](https://jmrplens.github.io/ghchronicle/es/sinks/telegraf/): Line protocol enviado a http_listener_v2, y la razón de que esto sea un destino en vez de cien. - [Fichero y stdout](https://jmrplens.github.io/ghchronicle/es/sinks/file/): Un fichero rotatorio para un agente de envío que ya tengas, el búfer duradero más simple que hay, y line protocol por la salida estándar. ## Dashboards - [Importar](https://jmrplens.github.io/ghchronicle/es/dashboards/): Cinco dashboards de Grafana generados, uno por almacén, y cómo importar cada uno. - [Qué muestran](https://jmrplens.github.io/ghchronicle/es/dashboards/panels/): Las diecisiete secciones y sus ciento cincuenta y dos paneles, una captura de cada una, y qué cambia cuando el almacén no puede responder. ## La tarjeta - [Resumen](https://jmrplens.github.io/ghchronicle/es/card/): Un SVG autocontenido para un README de perfil, dibujado con los mismos puntos que reciben las bases de datos. - [Diseños](https://jmrplens.github.io/ghchronicle/es/card/layouts/): Trece diseños en dos familias visuales, con lo que dibuja cada uno por omisión, cuáles se animan y cuáles pueden seguir moviéndose. ## Uso de la API - [Límites de la API](https://jmrplens.github.io/ghchronicle/es/api/): GitHub tiene quince presupuestos independientes; aquí importan tres, y el freno se escala a cada uno. - [Coste de una pasada](https://jmrplens.github.io/ghchronicle/es/api/cost/): El precio medido de una pasada, por familia, y qué familias alargar cuando el presupuesto aprieta. - [Lo que GitHub no da](https://jmrplens.github.io/ghchronicle/es/api/limits/): Los endpoints que se ha verificado que no funcionan en una cuenta personal, escritos para que nadie los vuelva a descubrir. ## Referencia - [La línea de órdenes](https://jmrplens.github.io/ghchronicle/es/reference/cli/): Las opciones, qué hace cada una y cuáles imprimen algo y salen. - [Llamarlo desde un programa](https://jmrplens.github.io/ghchronicle/es/reference/subprocess/): No hay biblioteca de Go. Lo que hay es una pasada, NDJSON por la salida estándar, y buenas razones para no llamarlo en bucle. - [Resolución de problemas](https://jmrplens.github.io/ghchronicle/es/reference/troubleshooting/): Los mensajes que parecen errores y no lo son, los que sí lo son, y los datos que parecen mal y no lo están. - [Las capas de prueba](https://jmrplens.github.io/ghchronicle/es/reference/testing/): Tres capas, y solo la primera es gratis: el contrato de los bytes, los almacenes reales en contenedores y las consultas propias de los dashboards. ## Referencias legibles por máquina - [Documentación completa](https://jmrplens.github.io/ghchronicle/es/llms-full.txt) (467 KB): todas las páginas en español concatenadas, en este orden Cada página de la lista se sirve también como markdown en su propia ruta con `index.md` al final, que es la forma más barata de leer una página como texto. ## Otros idiomas - [Índice de la documentación en inglés](https://jmrplens.github.io/ghchronicle/llms.txt): la misma documentación en inglés, página por página