Cato API - AccountMetrics > Sitios > Interfaces

AccountMetrics > Sitios > Interfaces

Los campos de AccountMetrics > Sitios > Interfaces contienen datos relacionados con los enlaces WAN del Socket para un sitio.

Campos de InterfaceMetrics

Los campos de InterfaceMetrics contienen datos para los enlaces WAN del Socket. Estos son los detalles y campos para la consulta:

  • métricas - datos de tráfico para el enlace (matriz con campos anidados)
  • nombre - nombre del enlace en la aplicación de gestión Cato
  • series temporales - marco temporal para los datos, y define la relación entre los contenedores y los datos (matriz con consultas y campos anidados)
  • anotaciones - anotación de marca de tiempo que muestra un incremento de tiempo para una GUI (matriz con consultas y campos anidados)
  • periodos - objeto que es una duración de tiempo específica (matriz con campos anidados)
  • info (InterfazSocket) - datos relacionados con el enlace, como la dirección IP de puerta de enlace (matriz con campos anidados)
  • infoIPremota - datos relacionados con la dirección IP del enlace, como el código de país (matriz con campos anidados)
  • IPremota - dirección IP del ISP para este enlace
  • infoSocket - datos relacionados con sitios de Socket y vSocket, como número de serie y versión de Socket (matriz con campos anidados)
  • infoIPsec - datos relacionados con sitios IPsec, como versión IKE (matriz con campos anidados)
  • infoInterfaz - información básica de configuración sobre la interfaz del Socket (matriz con campos anidados)

Métricas (InterfaceMetrics)

El campo Métricas muestra la analítica de tráfico para los enlaces WAN. Estos son los detalles de los campos:

  • duración - cantidad total de tiempo para los datos del Socket
  • granularidad - duración en segundos para un solo contenedor de métricas
  • bytesDescendentes - tráfico total descendente (desde la Nube Cato al Socket)
  • bytesAscendentes - tráfico total ascendente (desde el Socket a la Nube Cato)
  • bytesTotales - tráfico total para el Socket
  • paquetesPerdidosDescendentes - número de paquetes perdidos para tráfico descendente
  • pérdidaPorcDescendente - porcentaje de paquetes perdidos para tráfico descendente
  • paquetesPerdidosAscendentes - número de paquetes perdidos para tráfico ascendente
  • pérdidaPorcAscendente - porcentaje de paquetes perdidos para tráfico ascendente
  • paquetesDescendentes - paquetes descendentes totales
  • paquetesAscendentes - paquetes ascendentes totales
  • jitterAscendente - fluctuación para tráfico ascendente (diferencia en el retraso de tiempo en milisegundos (ms) entre paquetes de datos)
  • jitterDescendente - fluctuación para tráfico descendente (diferencia en el retraso de tiempo en milisegundos (ms) entre paquetes de datos)
  • paquetesDescartadosDescendentes - paquetes totales descartados para tráfico descendente
  • paquetesDescartadosAscendentes - paquetes totales descartados para tráfico ascendente
  • rtt - tiempo de ida y vuelta desde el Socket a la Nube Cato

Argumento toRate

Cuando el argumento booleano toRate está configurado en true, entonces los datos se devuelven por segundo. Cuando el argumento está configurado en false, entonces la consulta devuelve los datos durante todo el período de tiempo.

El argumento toRate solo se aplica a tipos con datos en bytes, no se aplica a rtt, salud, etc.

Nombre

El campo Nombre muestra el nombre del enlace configurado en la aplicación de gestión Cato (Configuración > Sitios > Configuración Socket).

Series temporales

Los campos de series temporales de InterfaceMetrics muestran las métricas del enlace según el marco temporal especificado (contenedores) en la consulta. Incluye estadísticas y métricas históricas y casi en tiempo real.

Los detalles de los campos y argumentos de series temporales de InterfaceMetrics son los mismos que los de series temporales de AccountMetrics, ver Cato API - AccountMetrics > Series temporales.

Anotaciones

Los campos y argumentos de Anotaciones muestran eventos específicos según el tiempo y el tipo de evento. Estos son los detalles de los campos:

  • hora - marca de tiempo del evento
  • etiqueta - descripción del evento
  • etiquetaCorta - breve descripción del evento
  • tipo - tipo de evento
    • cambioPop - el sitio se conecta a un PoP diferente
    • cambioRol - cambio en el rol de estado HA
    • cambioIPremota - la dirección IP del ISP (IP remota) cambió
    • genérico - otros eventos que se incluyen en las anotaciones

Argumento Tipos de Anotaciones

Especificar el tipo de evento que se incluye en la consulta: cambioPop, cambioRol, o genérico.

Periodos

Los campos de Periodos muestran las métricas de PeriodType para la duración de tiempo especificada. Estos son los detalles de los campos:

  • duración - un par de dos números que representan el inicio y fin (en ms) según el índice para el índice de contenedor de inicio y fin
  • título - etiqueta que describe las métricas
  • tipo - una matriz enumerada que identifica el tipo de datos para este período:
    • pérdidaPaquete - pérdida de paquetes debido a un problema de conectividad
    • datosFaltantes - no hay datos disponibles para el período
    • enlacePasivo - el enlace está en modo de espera y no transmite tráfico
    • activo - el enlace está en carga activa y transmite tráfico
    • desbordado - algunos paquetes fueron encolados y enviados después de un retraso
    • congestionado - algunos paquetes fueron descartados porque se agotaron en la cola
    • pérdidaPaqueteÚltimaMilla - pérdida de paquetes medida entre el Socket y el PoP
    • latenciaÚltimaMilla - latencia medida entre el Socket y el PoP
    • genérico - algo afectó el enlace de una manera desconocida
    • pop - PoP específico al que el enlace está actualmente conectado

infoIPremota

Los campos de infoIPremota muestran datos que dirección IP para el enlace. Estos son los detalles de los campos relacionados con la dirección IP:

  • ip - dirección IP del enlace
  • códigoPaís - código de país ISO de geolocalización
  • nombrePaís - nombre de país de geolocalización
  • ciudad - ciudad de geolocalización
  • estado - estado de geolocalización
  • proveedor - Proveedor de Internet ISP
  • latitud - latitud de geolocalización para el ISP
  • longitud - longitud de geolocalización para el ISP

IPremota

El campo IPremota muestra la dirección IP del enlace, sin los datos adicionales de infoIPremota.

socketInfo

El campo socketInfo muestra datos sobre el Socket, como el número de versión y el número de serie. Estos son los detalles para los campos:

  • id - ID único para el Socket
  • serial - número de serie para el Socket
  • isPrimary - para configuraciones HA, cuando este valor booleano es verdadero, este el Socket primario
  • platform - Muestra el tipo de Socket:
    • not_set - no se ha establecido una plataforma para el Socket
    • VM - valor anterior
    • X1 - valor anterior
    • X1500 - Socket X1500
    • NATIVE - valor anterior
    • X1500_BR2 - Por definir
    • X1700 - Socket X1700
    • AWS1500 - AWS vSocket
    • RPI64 - valor anterior
    • AZ1500 - Azure vSocket
    • ESX1500 - VMware ESX vSocket
  • version - número de versión del software que está actualmente instalado en el Socket
  • versionUpdateTime - timestamp cuando el Socket se actualizó a la versión de hardware actual

ipsecInfo

El campo ipsecInfo muestra datos sobre la Configuración de conexión para el sitio IPsec. Estos son los detalles para los campos:

  • isPrimary - para configuraciones HA, cuando este valor booleano es verdadero, este es el firewall IPsec primario o el dispositivo de enrutamiento
  • catoIP - La dirección IP de Fuente para el túnel IPsec en la Nube de Cato.
  • remoteIP - la dirección IP de Destino para el túnel IPsec (en el sitio)
  • ikeVersion - muestra 1 para IKEv1 y 2 para IKEv2

interfaceInfo

Los campos interfaceInfo contienen datos relacionados con los puertos de Socket para un sitio que están Configurados en la Aplicación de Gestión de Cato (Configuration > Sites > Socket Configuration). Estos son los detalles para los campos:

  • id - ID para el puerto del Socket en la pestaña Monitor de la Interfaz Web del Socket
  • name - Nombre para el puerto en la Aplicación de Gestión de Cato
  • upstreamBandwidth - Ancho de Banda máximo permitido en este puerto, para el tráfico del sitio a la Nube de Cato
  • downstreamBandwidth - Ancho de Banda máximo permitido para el tráfico en este puerto, desde la Nube de Cato al sitio

¿Fue útil este artículo?

Usuarios a los que les pareció útil: 1 de 1

0 comentarios