Cato API - AccountMetrics > Sitios > Interfaces

AccountMetrics > Sitios > Interfaces

El campo AccountMetrics > Sites > Interfaces contiene datos relacionados con los enlaces WAN de Socket para un Site.

Campos de InterfaceMetrics

El campo InterfaceMetrics contiene datos para los enlaces WAN de 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 Cato Management Application
  • serie temporal - periodo de tiempo para los datos, y define la relación entre los buckets y los datos (matriz con consultas y campos anidados)
  • anotaciones - anotación de marca de tiempo que muestra un incremento de tiempo para una interfaz gráfica (matriz con consultas y campos anidados)
  • períodos - objeto que es una duración de tiempo específica (matriz con campos anidados)
  • info (SocketInterface) - datos relacionados con el enlace, como la dirección IP del Gateway (matriz con campos anidados)
  • remoteIPinfo - datos relacionados con la dirección IP del enlace, como el código del país (matriz con campos anidados)
  • remoteIP - dirección IP del ISP para este enlace
  • socketInfo - datos relacionados con los sitios Socket y vSocket, como el número de serie y la versión de Socket (matriz con campos anidados)
  • ipsecInfo - datos relacionados con los sitios IPsec, como la versión de IKE (matriz con campos anidados)
  • interfaceInfo - información básica de configuración sobre la interfaz Socket (matriz con campos anidados)

Métricas (InterfaceMetrics)

El campo Métricas muestra los análisis de tráfico para los enlaces WAN. Estos son los detalles de los campos:

  • duración - cantidad total de tiempo para los datos de Socket
  • granularidad - duración en segundos para un único bucket de métricas
  • bytesDownstream - tráfico total descendente (desde la Cato Cloud hasta el Socket)
  • bytesUpstream - tráfico total ascendente (desde el Socket hasta la Cato Cloud)
  • bytesTotal - tráfico total para el Socket
  • lostDownstream - número de paquetes perdidos para el tráfico descendente
  • lostDownstreamPcnt - porcentaje de paquetes perdidos para el tráfico descendente
  • lostUpstream - número de paquetes perdidos para el tráfico ascendente
  • lostUpstreamPcnt - porcentaje de paquetes perdidos para el tráfico ascendente
  • packetsDownstream - total de paquetes descendentes
  • packetsUpstream - total de paquetes ascendentes
  • jitterUptstream - jitter para el tráfico ascendente (diferencia en el retraso de tiempo en milisegundos (ms) entre paquetes de datos)
  • jitterDownstream - jitter para el tráfico descendente (diferencia en el retraso de tiempo en milisegundos (ms) entre paquetes de datos)
  • packetsDiscardedDownstream - total de paquetes descartados para el tráfico descendente
  • packetsDiscardedUpstream - total de paquetes descartados para el tráfico ascendente
  • rtt - tiempo de ida y vuelta desde el Socket hasta la Cato Cloud

Argumento toRate

Cuando el argumento booleano toRate se establece en true, entonces los datos se devuelven por segundo. Cuando el argumento se establece en false, la consulta devuelve los datos sobre todo el periodo de tiempo.

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

Nombre

El campo Nombre muestra el nombre del enlace que está configurado en la Cato Management Application (Configuration > Sites > Socket Configuration).

Serie Temporal

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

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

Anotaciones

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

  • tiempo - marca de tiempo del evento
  • etiqueta - descripción del evento
  • etiquetaCorta - breve descripción del evento
  • tipo - tipo de evento
    • cambioDePop - el sitio se conecta a un PoP diferente
    • cambioDeRol - cambio para el rol de estado HA
    • cambioDeIPRemota - la dirección IP del ISP (IP remota) cambió
    • genérico - otros eventos que están incluidos en anotaciones

Argumento de Tipos de Anotaciones

Especifique el tipo de evento que se incluye en la consulta: cambioDePop, cambioDeRol o genérico.

Períodos

Los campos de Períodos 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 tiempo de inicio y fin (en ms) según el índice para el índice de bucket de inicio y fin
  • título - Etiqueta que describe las métricas
  • tipo - Una matriz de enumeración que identifica el tipo de datos para este período:
    • pérdidaDePaquete- pérdida de paquetes debido a un problema de conectividad
    • datosFaltantes - no hay datos disponibles para el periodo
    • enlacePasivo - el enlace está en modo de espera y no pasa tráfico
    • activo - el enlace está en carga activa y pasa tráfico
    • desbordado - algunos paquetes se pusieron en cola y se enviaron después de un retraso
    • congestionado - algunos paquetes fueron descartados porque expiraron en la cola
    • pérdidaDePaqueteDeÚltimaMilla - pérdida de paquetes medida entre el Socket y el PoP
    • latenciaDeÚltimaMilla - latencia medida entre el Socket y el PoP
    • genérico - algo afectó el enlace desde un desconocido
    • pop - PoP específico al que el enlace está actualmente conectado

remoteIPInfo

Los campos de remoteIPInfo muestran datos que la 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ódigoDePaís - código de país geolocalización ISO
  • nombreDePaís - nombre de país geolocalización
  • ciudad - ciudad de geolocalización
  • estado - estado de geolocalización
  • proveedor - ISP proveedor de Internet
  • latitud - latitud de geolocalización para el ISP
  • longitud - longitud de geolocalización para el ISP

remoteIP

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

socketInfo

El campo socketInfo muestra información sobre el Socket, como número de versión y número de serie. Estos son los detalles de 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, es el Socket primario
  • plataforma - Muestra el tipo de Socket:
    • no_establecido - no se ha establecido plataforma para el Socket
    • VM - valor legado
    • X1 - valor legado
    • X1500 - Socket X1500
    • NATIVE - valor legado
    • X1500_BR2 -
    • X1700 - Socket X1700
    • AWS1500 - AWS vSocket
    • RPI64 - valor legado
    • AZ1500 - Azure vSocket
    • ESX1500 - VMware ESX vSocket
  • versión - número de versión de software que está actualmente instalado en el Socket
  • versionUpdateTime - marca de tiempo cuando el Socket se actualizó a la versión de hardware actual

ipsecInfo

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

  • isPrimary - para configuraciones HA, cuando este valor booleano es verdadero, es el firewall o dispositivo de enrutamiento IPsec primario
  • catoIP - La dirección IP de origen para el túnel IPsec en la Cato Cloud
  • 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 de interfaceInfo contienen datos relacionados con los puertos de Socket para un sitio que están configurados en la Cato Management Application (Configuration > Sites > Socket Configuration). Estos son los detalles de los campos:

  • id - ID para el puerto Socket en la pestaña Monitor del Socket WebUI
  • nombre - nombre para el puerto en la Cato Management Application
  • anchoDeBandaAscendente - Ancho de banda máximo permitido en este puerto, para tráfico desde el sitio hasta la Cato Cloud
  • anchoDeBandaDescendente - Ancho de banda máximo permitido para tráfico en este puerto, desde la Cato Cloud al sitio

¿Fue útil este artículo?

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

0 comentarios