{"canonical_url":"https://engineer.company/es/glossary/metrics/","content_markdown":"# Métricas\n\n## Qué es\n\nLas métricas son mediciones de un servicio en ejecución, tomadas en un instante\ny conservadas como un valor con marca de tiempo y unas pocas etiquetas. Así\npuede volver a consultarse la misma magnitud un minuto, un día o un mes después.\nUna magnitud con nombre es una métrica; almacenada como una secuencia de valores\na lo largo del tiempo, forma una serie temporal. OpenTelemetry cuenta las\nmétricas entre sus señales, junto con trazas y logs. Son ejemplos habituales las\nsolicitudes atendidas, la memoria en uso y los trabajos que esperan en una cola.\n\nLa agregación distingue las métricas de las demás señales. Un log conserva una\nlínea por evento y una traza sigue una solicitud por el sistema. Una métrica\nresume muchas mediciones en unas pocas estadísticas dentro de una ventana\ntemporal: un recuento, una suma, un valor actual o una distribución por\nintervalos. La documentación de OpenTelemetry llama al resultado información\nestadística agregada. Ahí están su fuerza y su límite: una métrica dice cuántas\nsolicitudes fallaron en el último minuto; un log indica cuáles.\n\nOpenTelemetry y Prometheus coinciden en unos pocos tipos; elegir el adecuado es\nla mayor parte del diseño:\n\n- Un **contador** acumula y solo crece, como el cuentakilómetros de un coche:\n  solicitudes atendidas, bytes enviados, errores observados. Prometheus admite una\n  excepción: restablecerlo a cero cuando se reinicia el proceso.\n- Un **contador ascendente y descendente**, según la terminología de\n  OpenTelemetry, acumula, pero también puede bajar; por ejemplo, la longitud de\n  una cola cuando entran y salen trabajos.\n- Un **indicador**, o gauge, es un valor actual leído en el momento de la\n  medición, como el indicador de combustible del mismo coche: memoria en uso,\n  temperatura, solicitudes en curso.\n- Un **histograma** clasifica mediciones en intervalos y conserva su recuento y\n  suma; así puede responder cuántas solicitudes tardaron menos de un segundo.\n\nPrometheus también tiene un resumen, que calcula cuantiles dentro del programa.\nEl modelo de datos de OpenTelemetry solo lo conserva como tipo heredado, porque\nlos resúmenes no siempre pueden combinarse con sentido.\n\nEl formato de texto que recoge Prometheus reúne las piezas: una línea de ayuda,\notra de tipo y, después, una línea por combinación de etiquetas con el nombre,\nlas etiquetas, el valor y una marca de tiempo opcional en milisegundos desde el\ninicio de la época:\n\n```text\n# HELP http_requests_total The total number of HTTP requests.\n# TYPE http_requests_total counter\nhttp_requests_total{method=\"post\",code=\"200\"} 1027 1395066363000\nhttp_requests_total{method=\"post\",code=\"400\"} 3 1395066363000\n```\n\n## Por qué importa\n\nLas métricas son lo bastante baratas como para conservar mediciones de todo el\nsistema. La memoria que necesitan crece con las combinaciones distintas de\netiquetas, en lugar de con el tráfico; la documentación de OpenTelemetry lo dice\nexpresamente, en contraste con los logs. Un contador incrementado mil millones\nde veces sigue siendo un número. Eso permite contar todas las solicitudes, en\nlugar de una muestra, y conservar los recuentos lo suficiente para comparar este\nmes con el anterior.\n\nConvierten discusiones en mediciones. Si un servidor tiene capacidad suficiente,\nsi una versión ralentizó las respuestas o cuándo se llenará un disco: cada\npregunta encuentra respuesta en una serie registrada antes de formularla. Las\nalertas se construyen con las mismas cifras: una regla de alerta es una\ncondición sobre una métrica por la que alguien decidió que merecía la pena\ndespertarse.\n\nTambién sobreviven al código que las emite; conviene acertar con su estructura.\nLa guía de nombres de Prometheus pide una unidad y una magnitud por métrica, con\nunidades básicas como segundos y bytes, en lugar de milisegundos o megabytes, la\nunidad como sufijo plural y `_total` para un recuento acumulativo. Nombres como\n`http_request_duration_seconds` y `process_cpu_seconds_total` indican así a\nsimple vista qué contienen.\n\nTambién importa cómo se transmiten los totales. Prometheus informa de totales\nacumulados: los huecos causados por fallos intermitentes de recogida quedan\ncompensados, a cambio de memoria en el emisor proporcional a sus\ncombinaciones de etiquetas. StatsD informa de deltas, el cambio desde el último\nenvío, trasladando ese coste fuera del proceso.\n\n## Cómo se aplica en la práctica\n\nEl servidor de la empresa para sus servicios de acceso público es una máquina de un solo núcleo\ncon 512 MB de memoria, unos 464 MB utilizables; allí, la memoria se convirtió en\nel argumento que resolvía decisiones. Los informes se obtienen a petición: siete\nórdenes leen el servidor y generan Markdown, sin cambiar nada y solo cuando se\nsolicitan. Cuando se planteó\n[si ese servidor de 512 MB también podía alojar un servicio onion](/es/portfolio/a-whole-company-on-one-small-server/),\nla respuesta vino de muestras registradas durante un día, en lugar de una\nopinión: en esas muestras, la memoria disponible nunca bajó de unos 310 MB de 464, el intercambio se mantuvo en el 2,6\n% y el procesador estuvo inactivo el 99,7 %.\n\nDespués, esos informes tuvieron que explicar qué valor tenían sus cifras.\n[Se hizo que seis recolectores de solo lectura dejasen constancia de lo que nunca leían](/es/portfolio/made-six-collectors-state-what-they-skipped/)\nal comprobar que una recogida ciega y un servidor sano producían la misma\npágina: una réplica cuyo demonio había cambiado el formato del log daba el mismo\ncero que otra que nadie visitaba. Los umbrales se ajustaron a las 116 muestras\nya medidas por el informe de métricas, anotando los intervalos observados junto\na los límites. El informe distingue tres resultados: incumplimiento, ausencia de\nincumplimiento y no evaluado porque nada lo midió. Cada recolector comunica su\nduración y sus puntos ciegos, por ejemplo archivos leídos frente a ilegibles,\nincluso si la respuesta es cero. Los límites se aplican a los promedios diarios, que pueden\nocultar un pico de un minuto. El mecanismo de vigilancia que se ejecuta cada quince\nminutos comprueba en cada ejecución la memoria disponible y el espacio libre en disco, pero\naún puede pasar inadvertido un incumplimiento breve entre comprobaciones.\n\nLas métricas más útiles suelen proceder del problema, no del servidor. La nota\nsobre\n[vender existencias limitadas sin sobreventa](/es/notes/selling-limited-stock-without-overselling/)\nreúne en un panel las esperas por bloqueos, las reservas caducadas y la\ndiferencia entre el recuento de la puerta de admisión y el de la base de datos.\nEjecuta de forma programada la invariante `available + held + sold = total`, la\nrepresenta y avisa al personal de guardia ante cualquier desviación. Cada cifra\nnace de conocer cómo puede fallar esa venta.\n\n## Dónde surgen los problemas\n\nLas métricas rara vez fallan de forma ruidosa. El gráfico sigue dibujándose y el\nnúmero pasa a significar, silenciosamente, algo distinto de lo que dice su\nnombre.\n\n**Se publica como contador un valor que baja.** La página de tipos de Prometheus\nindica que no debe usarse un contador para nada que pueda disminuir, como el\nnúmero de procesos en ejecución: eso es un indicador. Las funciones de consulta\ninterpretan cualquier caída de un contador como un reinicio y la corrigen; un\nvalor que baja deliberadamente aparece entonces como aumentos que nunca\nocurrieron.\n\n**Las unidades cambian entre servicios.** Uno informa de la duración en\nmilisegundos y otro en segundos; el panel que los compara se equivoca por un\nfactor de mil. La guía de nombres exige que una métrica corresponda a una sola\nunidad y recomienda las básicas. Convertir una vez, en origen, cuesta menos que\nrecordar la diferencia en cada consulta.\n\n**La suma entre etiquetas no significa nada.** La regla orientativa de la guía\nde nombres es que la suma o el promedio sobre todas las etiquetas de una métrica\ndebería tener sentido. Su propio ejemplo: las capacidades de varias colas\npertenecen a una misma métrica; la capacidad de una cola y su longitud actual,\nno.\n\n**Lo no medido se lee como cero.** Un recolector que deja de leer su entrada\ndeja un cero o una fila ausente indistinguibles de un sistema con poca\nactividad. El modelo de OpenTelemetry incluye una marca para un punto sin valor\nregistrado, equivalente al marcador de datos obsoletos de Prometheus, porque la\nausencia de datos y un cero son hechos distintos. Repórtelos de forma diferente\ny dé a «no evaluado» un resultado propio, como hacen los recolectores\nanteriores.\n\n**La ventana oculta el pico.** Un indicador es una muestra de un instante; el\nmodelo de OpenTelemetry solo comunica el último valor de cada intervalo, por lo\nque una ráfaga entre dos muestras no deja huella. Del mismo modo, un promedio\ndiario diluye un minuto al límite. Elija la ventana según el fallo que deba\nverse y mantenga una comprobación rápida junto a otra lenta cuando ambas\nimporten.\n\n**El desbordamiento hace que una consulta filtrada cuente de menos.** El SDK de\nOpenTelemetry registra, de forma predeterminada, como máximo 2.000 combinaciones distintas\nde atributos por flujo de métricas y agrupa las siguientes en un único punto\nmarcado como `otel.metric.overflow=true`. El total sigue siendo correcto, pero\nel desbordamiento sustituye la combinación completa, no solo su parte ruidosa.\nEn el ejemplo de la documentación, un contador de solicitudes lleva `url.path` y\n`success`; al desbordarse, una consulta con `success=false` cuenta de menos y\nuna alerta de tasa de errores basada en ella puede dejar de dispararse. Limite\nlos atributos a conjuntos pequeños y conocidos y vigile la marca de\ndesbordamiento.\n\n## Lecturas adicionales\n\n- [OpenTelemetry: métricas](https://opentelemetry.io/docs/concepts/signals/metrics/)\n  — tipos de instrumentos, agregación y límite de cardinalidad.\n- [OpenTelemetry: modelo de datos de métricas](https://opentelemetry.io/docs/specs/otel/metrics/data-model/)\n  — indicadores, sumas, histogramas, temporalidad y marca de ausencia de valor\n  registrado.\n- [Prometheus: tipos de métricas](https://prometheus.io/docs/concepts/metric_types/)\n  — contador, indicador, histograma y resumen.\n- [Prometheus: nombres de métricas y etiquetas](https://prometheus.io/docs/practices/naming/)\n  — unidades básicas, sufijos de unidad y `_total`.\n- [Prometheus: histogramas y resúmenes](https://prometheus.io/docs/practices/histograms/)\n  — dónde se calculan los cuantiles y cuáles pueden combinarse.\n- [Prometheus: formatos de exposición](https://prometheus.io/docs/instrumenting/exposition_formats/)\n  — el formato de texto línea por línea.\n\n\u003chttps://engineer.company/es/glossary/metrics/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Contadores, indicadores e histogramas resumen un servicio en cifras. Sus etiquetas, unidades y ventanas deciden qué se ve y qué puede pasar inadvertido.","formats":{"gemtext":"https://engineer.company/es/glossary/metrics/index.gmi","gopher":"https://engineer.company/es/glossary/metrics/gophermap","html":"https://engineer.company/es/glossary/metrics/","json":"https://engineer.company/es/glossary/metrics/index.json","markdown":"https://engineer.company/es/glossary/metrics/index.md","pdf":"https://engineer.company/es/glossary/metrics/index.pdf"},"kind":"page","language":"es","title":"¿Qué son las métricas?","url":"https://engineer.company/es/glossary/metrics/","version":1}