InfluxDB 3

--influx escribe la línea temporal fusionada como protocolo de líneas de InfluxDB en el /api/v3/write_lp de InfluxDB 3. Conserva cada muestra a la cadencia del agente, y es el destino que lee el panel de InfluxDB. Añade --grafana <url> y el colector crea además la fuente de datos de InfluxDB y publica el dashboard al arrancar; mikroscope dashboards publish con las mismas opciones lo hace una sola vez, sin recoger (Publicar desde el colector).

URL y token

export MIKROSCOPE_INFLUX_URL=http://host:8181
export MIKROSCOPE_INFLUX_DB=mikroscope
export MIKROSCOPE_INFLUX_TOKEN=…
mikroscope forward --influx "$MIKROSCOPE_INFLUX_URL" --influx-db "$MIKROSCOPE_INFLUX_DB" --host-tag router1

Opción	Por defecto	Qué ajusta
--influx	MIKROSCOPE_INFLUX_URL	El servidor. El destino arma la URL de escritura, http://host:8181/api/v3/write_lp?db=mikroscope&precision=nanosecond.
--influx-db	MIKROSCOPE_INFLUX_DB	La base de datos.
ninguna	MIKROSCOPE_INFLUX_TOKEN	El token, que se envía como Authorization: Bearer <token>. Se lee solo de la variable, nunca de una opción.

• Un servidor sin base de datos se rechaza al arrancar: --influx names a server but no database: pass --influx-db (MIKROSCOPE_INFLUX_DB).
• Un --influx que lleva ruta se toma tal cual como URL de escritura. Usa esa forma para el /api/v2/write de InfluxDB 2 (sin probar). Entonces --influx-db se ignora, y la base de datos que describe forward --grafana se lee del db= de la URL.

Pon la URL entre comillas

Cuando una URL de escritura completa está en un fichero que cargas con source, ponla entre comillas: & es un operador del shell, y un …?db=mikroscope&precision=nanosecond sin comillas se corta en el &.

Entrega

• Un lote por segundo. Cada evento se renderiza en el lote actual según llega; una goroutine lo pasa a la cola y lo envía una vez por segundo, con un tiempo de espera de 10 s por envío.
• Una cola acotada. --queue-seconds (60 por defecto) × 64 KiB. Pasado eso se descarta y se cuenta el lote más antiguo; el más nuevo nunca se descarta.
• Espera entre reintentos. Un envío fallido espera 2 s, doblando hasta 60 s, y registra como mucho una línea por minuto. Una respuesta que no es 2xx es un error, con los primeros 512 bytes del cuerpo en esa línea.
• Sin reenvío silencioso. Una petición cuya conexión reutilizada resulta estar muerta se informa como error y la reintenta el destino, en vez de reenviarla el cliente HTTP por su cuenta (por qué).

Una muestra del kernel a 10 Hz se renderiza en unos 1,2 KiB de protocolo de líneas (medido). Así que un segundo de presupuesto guarda unas 50 muestras — unos 5 s de atraso a 10 Hz — y los 60 s por defecto guardan unos 5 minutos. Los tamaños por encima de 10 Hz y con el conjunto de fuentes actual no se han medido.

Los contadores van en lotes: written un lote que InfluxDB aceptó, dropped un lote expulsado, errors un intento fallido.

Medidas

Cada medida se llama mikroscope_<subject> y lleva host=<--host-tag>. Las filas de la capa del kernel se marcan con el reloj de pared del agente en nanosegundos; la tabla indica las excepciones. Las listas de campos están en Esquema de los almacenes.

Capa del kernel

Medida	Tags	Lleva
mikroscope_cpu	cpu	los deltas de ticks por modo, busy_ratio y el intervalo real de la muestra dt_ns
mikroscope_cpufreq	cpu	khz, con el max_khz del núcleo en la misma fila donde se publica
mikroscope_softnet	cpu	deltas de processed, dropped, time_squeeze
mikroscope_irq	irq, name	la cuenta de interrupciones sumada sobre las CPU, para las fuentes del top-K
mikroscope_irq_cpu	irq, name, cpu	la misma cuenta por CPU, solo filas con delta distinto de cero
mikroscope_softirq	kind, cpu	deltas de softirq por vector y CPU, solo distintos de cero
mikroscope_sample	—	seq, dt_ns, mono_ns
mikroscope_stat	—	los deltas de /proc/stat: ctxt, intr, forks, irq_total, irq_err
mikroscope_mem	—	niveles de /proc/meminfo, en _kb
mikroscope_load	—	medias de carga, running, threads, procs_blocked
mikroscope_vm	—	deltas de contadores de /proc/vmstat: fallos, escaneos y robos de reclaim, bloqueos, oom_kill, swap
mikroscope_vm_level	—	niveles de /proc/vmstat: nr_free_pages, nr_dirty, nr_writeback, páginas de slab
mikroscope_buddy	node, zone	bloques libres por orden y free_pages, en las muestras en las que cambiaron las listas libres
mikroscope_self	—	la CPU, el RSS, la memoria de cgroup y memory.max del propio agente; sus eventos de cgroup donde se leyó cgroup2; resets; kmsg_dropped
mikroscope_psi	—	microsegundos de bloqueo, solo donde el kernel tiene PSI
mikroscope_thermal	zone	celsius, con el critical_celsius de la zona donde declara uno
mikroscope_slab	cache	objetos activos, con limit donde el kernel publica uno (nf_conntrack)
mikroscope_mtd	device, partition	contadores ECC de la flash tal como se leen, con los umbrales de la partición donde se publican
mikroscope_flash	device	escrituras, lecturas y borrados de páginas YAFFS, GC; niveles bad_blocks y free_chunks
mikroscope_disk	device	deltas de lectura y escritura del dispositivo de bloques, io_s, inflight
mikroscope_perf	counter, cpu	cuenta de PMU, con enabled_ns y running_ns en la misma fila
mikroscope_kmsg	level, port, kind, label, role	una cuenta de registros del log del kernel por nivel, no el texto; un registro que nombra un puerto se cuenta por nivel, puerto y tipo, con su label y su role donde se conocen
mikroscope_derived	—	los valores de la etapa de derivación junto a la muestra

Los contadores se escriben como deltas sin signo; los niveles, como el valor absoluto que informó el kernel. Son medidas separadas donde una fuente tiene ambos (mikroscope_vm frente a mikroscope_vm_level), porque un delta es una tasa de eventos y un nivel es una profundidad, y una sola medida invita a un panel a sumar un nivel o a sacar la tasa de un gauge.

Una fuente que el despliegue no puede leer no escribe ninguna fila, nunca una fila a cero: las filas de PSI solo existen donde el kernel tiene PSI, y las de slab, del log del kernel, de MTD y de PMU necesitan privileged=yes. Las fuentes de nivel que el agente guarda al cambiar solo aparecen en las muestras que las llevan; consulta cada fuente a su propio suelo.

Un running_ns por debajo de enabled_ns en una fila de mikroscope_perf significa que esa cuenta es una estimación multiplexada y escalada a la baja. El texto del log del kernel va a Loki; lo que puede responder un almacén de métricas es cuándo empezó el router a producir avisos, en qué puerto y de qué tipo. kind es la clasificación de un registro que nombra un puerto: link-up, link-down, stp-blocking y sus hermanos (listening, learning, forwarding, disabled), own-address — el bridge recibió una trama con su propia MAC como dirección de origen, la firma de un bucle de capa 2 — u other. Un registro que no nombra ningún puerto mantiene la forma sin tags y lleva solo level. Un link-up normal va seguido de stp-blocking, stp-learning y stp-forwarding en su puerto del bridge: cuatro registros, no cuatro fallos.

Capa de la API y derivados

Medida	Tags	Lleva	Reloj
mikroscope_api_system	—	cpu_load, free_memory, total_memory, free_hdd, uptime_s	colector + desfase
mikroscope_api_core	cpu	el porcentaje load, irq, disk por núcleo de RouterOS	colector + desfase
mikroscope_api_health	name	cada valor de /system/health	colector + desfase
mikroscope_api_iface	interface, label, type, role, bridge	tasas de monitor-traffic, y cada tasa de pérdidas que devolvió el router	colector + desfase
mikroscope_api_ifcounters	interface, label, type, role, bridge	cada contador acumulado por puerto que devolvió el router, con - convertido en _	colector + desfase
mikroscope_api_ifinfo	interface, label, type, role, bridge	default_name y mtu: qué es cada interfaz, al arrancar y cada --labels-every	colector + desfase
mikroscope_api_conntrack	—	entries, cuando --conntrack-every lo pide	colector + desfase
mikroscope_derived_iface	interface	la proporción del fast path de lo que la interfaz entrega a la CPU, junto a los deltas de bytes de los que salió	colector + desfase
mikroscope_gap	—	from, to: el rango de secuencia que nunca llegó	colector, al notarlo
mikroscope_detection	rule, key	value, threshold, seq, message	la muestra que la provocó
mikroscope_trigger	cause	id, seq, value, threshold, field: la captura está en el agente	el agente, al dispararse
mikroscope_device	board, kernel	cores, privileged, cgroup, sources, hash, y los techos que publica la placa	colector
mikroscope_device_thermal	zone	critical_celsius, polling_ms	colector
mikroscope_device_cpufreq	cpu	cluster, min_khz, max_khz, governor, steps	colector
mikroscope_device_cadence	source, reason	hz	colector
mikroscope_sampler	—	ticks, slipped, captures_held, capture_bytes, capture_budget_bytes, capture_served_bytes	colector, desde GET /sampler
mikroscope_trigger_count	condition	fired	colector, desde GET /sampler
mikroscope_trigger_suppressed	condition, reason	count	colector, desde GET /sampler
mikroscope_capture_refused	reason	count	colector, desde GET /sampler

Cada fila de una interfaz lleva qué es esa interfaz: label es su comentario de RouterOS, type es el tipo propio de RouterOS (ether, bridge, vlan, pppoe-out, wg, veth, loopback), role son sus listas de interfaces ordenadas y unidas por comas (WAN, LAN,VPN — un miembro de un bridge que no está en ninguna lista propia toma las listas de su bridge, que es como las reglas de firewall de RouterOS lo emparejan) y bridge es el bridge del que es puerto. Cada uno se omite en vez de enviarse vacío, para que la clave de la serie de una interfaz que no lo tiene siga estable, y para que un panel pueda separar los puertos de cable (type=ether) del lado de CPU del bridge (type=bridge), o la WAN de la LAN. Un campo de pérdidas solo se escribe cuando el router devolvió esa clave.

mikroscope_api_ifinfo lleva esos cinco tags para cada interfaz que leyó el colector, esté o no en la lista de --interfaces, con default_name (el nombre de fábrica de un puerto físico, una cadena vacía para un bridge, una VLAN o un túnel) como campo de texto y mtu donde el router informa de uno mayor que cero. Se escribe una vez antes del primer sondeo del kernel y de nuevo en cada relectura de --labels-every, 5 minutos por defecto, y es la tabla con la que un panel cruza para decir qué es una interfaz. mikroscope_api_ifcounters lleva solo contadores: mtu, actual-mtu, l2mtu, max-l2mtu y sfp-shutdown-temperature se leen como enteros, pero son tamaños y configuración, no cuentas, así que no son campos ahí; la MTU está en mikroscope_api_ifinfo.

El fp_rx_share de mikroscope_derived_iface es la proporción del fast path del tráfico que una interfaz entrega a la CPU: fp-rx-byte sobre driver-rx-byte en un puerto del switch, cuyo rx-byte es el total del cable, y sobre rx-byte en una interfaz por software. No es una proporción del cable: las tramas que el chip del switch reenvía por hardware no están en ninguno de los dos números. fp_tx_share se retiene, y el denominador tx_bytes que lo acompaña se escribe como 0, mientras el fp-tx-byte acumulado sea 0, como puede serlo en todas las interfaces de un router tras cientos de GB transmitidos (observado).

Límites de InfluxDB 3 Core

• Un nodo guarda como mucho cinco bases de datos, el límite que InfluxData documenta para Core. Una sexta escritura falla con 422: would exceed limit of 5 databases. El destino espera y sigue intentándolo, así que el síntoma es una cuenta de errors que sube, no una ejecución fallida.
• Toda consulta debe estar acotada en el tiempo.
• El tipo de una columna no se puede cambiar una vez escrito.
• Una columna solo existe cuando una fila la ha llevado. mikroscope_kmsg no tiene columna kind hasta que se escribe el primer registro del log del kernel que nombra un puerto, y una consulta que filtre por ella antes falla al planificarse — por eso la forma SQL de las reglas de alerta del bucle de capa 2 y de caída de enlace necesita un almacén que ya haya guardado un registro de puerto clasificado. mikroscope_api_ifcounters solo tiene los contadores que ha devuelto el router: bridge, rx_packet, tx_unicast y tx_broadcast, que lee la regla bridge-port-dark, solo existen cuando la capa de la API ya ha escrito contadores de puerto, y una columna de error tipado que suma la regla port-errors, como rx_jabber o tx_late_collision, solo si el router ha informado alguna vez de ese contador.
• Un tag negado dentro de un OR puede no devolver nada, en silencio. NOT (port='ether2' AND kind IN (…)) sobre mikroscope_kmsg puede devolver 0 filas donde hay filas que coinciden, y lo mismo su forma de De Morgan y el OR explícito; filtrar también port='ether2' fuera del OR las devuelve (observado). Filtra en positivo, y comprueba cualquier respuesta vacía con un count(*) simple. Los paneles y las reglas que se distribuyen no usan ese patrón.

forward --grafana y dashboards publish construyen la fuente de datos de Grafana, con el token del destino, en la dirección en la que escribe el colector salvo que --grafana-datasource-url indique la que alcanza Grafana. Una creada a mano necesita dos campos seguros, no uno (Fuente de datos de InfluxDB 3).

Las ediciones y versiones de InfluxDB 3 en las que ha escrito el destino están en el estado de las funciones.

Véase también

• Esquema de los almacenes: cada campo de cada medida, con su unidad.
• Configurar en Grafana: el dashboard de InfluxDB, su fuente de datos y el sondeo del almacén.
• Ejecutar el colector: la cola, la espera entre reintentos y los contadores que comparten todos los destinos en cola.
• Datos del equipo: lo que guardan las cuatro medidas mikroscope_device*.