El contrato es deliberadamente trivial, porque la idea es que puedas leerlo de una sentada e
implementarlo en el lenguaje que ya usa tu equipo. HostTracker solicita tu URL; tu endpoint responde con
un objeto JSON que contiene el valor:
{ "v": 42.7 }
Esa es toda la superficie requerida. Dos miembros opcionales hacen el resultado más útil: e
lleva una cadena de error cuando el valor no pudo leerse esa vez - un resultado mucho mejor que reportar un
cero engañoso -, y vs lleva una cadena de versión propia, que aparece en el resultado para que
puedas saber qué versión del recolector respondió.
{ "v": 91.4, "e": "", "vs": "collector-2.1" }
Como tú escribes el lector, no estás limitado a lo que un agente genérico sabe recolectar. Profundidad de
cola, tasa de aciertos de caché, cantidad de trabajos en espera, antigüedad del registro sin procesar más
antiguo, inodos libres, el tamaño de un directorio que nunca debe crecer - cualquier cosa que puedas
expresar como un número se convierte en un valor monitoreado con umbrales, historial y alertas propios.
Protege el endpoint. Tiene que ser accesible para los verificadores que lo consultan,
así que trátalo como cualquier otra URL pública: colócalo en una ruta imposible de adivinar, mantenlo de
solo lectura, y expón solo los números con los que te sientas cómodo. No acepta parámetros que cambien
nada, lo que limita la exposición a exactamente un valor.