media server logo
PreciosIniciar sesiónLanzar en AWS
Documentación APIDescripción general
Ajustes generales
Puertos
Nodos del clúster
Utilidades adicionales
Almacenamientos
Mostrar u ocultar la navegación
Inicio de Callaba

Utilidades adicionales

Usa Utilidades adicionales para consultar el estado de la instancia, medir el rendimiento de la red, localizar una dirección IP y borrar los registros de errores acumulados.

Qué haceEjecutar una comprobación operativa

Elige este módulo cuandoNecesitas revisar el host, ancho de banda, ubicación IP o registros de errores.

Usa otro módulo cuandoUsa las estadísticas del módulo multimedia correspondiente si la pregunta afecta a un único stream o proceso.

1Elige la utilidad2Ejecuta la prueba3Usa el resultado
POST /api/utils/getStat
4 endpoints

Antes de empezar

getLocation es un método público de lectura. Las estadísticas, pruebas de ancho de banda y limpieza de registros requieren un x-access-token válido. Ejecuta las pruebas y la limpieza únicamente desde herramientas operativas de confianza, ya que pueden consumir recursos o eliminar información de diagnóstico.

Qué puedes hacer

  • getStat consulta las estadísticas disponibles de la instancia.
  • speedTest mide el rendimiento de red desde la instancia.
  • getLocation devuelve la ubicación detectada de la instancia.
  • clearErrorLogs borra los registros de errores acumulados.

Flujo de ejemplo

  1. Consulta las estadísticas actuales antes de modificar la carga.
  2. Ejecuta una prueba de velocidad fuera de la ventana de producción en directo.
  3. Compara el resultado con el bitrate previsto de entrada y salida.
  4. Exporta la información necesaria del incidente antes de borrar los registros.

Casos de uso habituales

  • Validar un nuevo host regional antes de enrutar hacia él un evento en directo.
  • Investigar si la capacidad de red explica la inestabilidad de un stream.
  • Confirmar la región detectada antes de asignar cargas de clientes.

Límites y resolución de problemas

Una prueba de velocidad mide la ruta actual y puede competir con el tráfico en directo; no garantiza la capacidad disponible. La ubicación es una referencia operativa, no una geolocalización física precisa. Borrar los registros es irreversible, por lo que primero debes conservar cualquier información que necesite el equipo de soporte.

Siguientes pasos

Usa el resultado para ajustar la capacidad del despliegue, la política de red o el módulo multimedia afectado.

Receta de solución REST

Comprobar la red de una instancia antes de un evento

Obtén la señal de ubicación pública y ejecuta una prueba de velocidad como parte de la validación antes de conectar fuentes.

  1. Confirmar ubicación públicaUsa los datos de dirección para detectar una región inesperada.POST /api/utils/getLocation
  2. Ejecutar la pruebaRegistra el resultado junto a la prueba real de la ruta SRT o RTMP.POST /api/utils/speedTest

Una prueba de velocidad es una señal puntual, no una garantía. Valida caudal sostenido, pérdidas, latencia y la ruta real.

POST
/api/utils/getStat
Requiere token de API

Obtén una instantánea rápida del estado de la instancia. Muestra CPU, RAM, disco, versión pública y errores acumulados de procesos o SRT antes de pasar al diagnóstico de un módulo concreto.

Parámetros del cuerpo de la solicitud
Este método no tiene parámetros
Obtener estado de la instancia
Copiar código
curl --request POST \
  --url http://localhost/api/utils/getStat \
  --header 'x-access-token: <your_api_token>' \
  --header 'Content-Type: application/json' \
  --data '{}'
Respuesta
Estado del host
cpuUsage / drive / RAM
mixed
Copiar enlace directo

Estado actual de CPU, disco y memoria del host de Callaba Engine.

Versiones
publicVersion
array
Copiar enlace directo

Metadatos de la versión publicada que el panel utiliza para comparar la compilación local con las versiones públicas disponibles.

Visibilidad de errores
srtErrors / processErrors
array
Copiar enlace directo

Conjuntos acumulados de errores de SRT y de procesos que el equipo de operaciones puede revisar antes de borrarlos.

Resultado de la operación
success
boolean
Copiar enlace directo

Las respuestas correctas incluyen success: true.

Respuesta: Obtener estado de la instancia
JSON
Copiar código
{
  "cpuUsage": 12.4,
  "drive": {
    "totalGb": "250.00",
    "usedGb": "81.00",
    "usedPercentage": "32.4"
  },
  "RAM": {
    "totalMemMb": 16384,
    "usedMemMb": 6240,
    "usedMemPercentage": 38.1
  },
  "publicVersion": [
    {
      "version_name": "stable",
      "version_number": "8.2"
    }
  ],
  "srtErrors": [],
  "processErrors": [],
  "success": true
}
POST
/api/utils/speedTest
Requiere token de API
POST
/api/utils/clearErrorLogs
Requiere token de API
POST
/api/utils/getLocation
Endpoint público
AnteriorNodos del clústerSiguienteDocumentación de Callaba Engine