Cato API - AccountSnapshot > Sites > Devices

AccountSnapshot > Sites > Devices

Este artículo explica los campos y datos de SiteSnapshot > Site> Devices relacionados con Sockets para un Site.

Campos de DeviceSnapshot

Los campos de DeviceSnapshot contienen datos para los Sockets y sus enlaces. La misma infraestructura de DeviceSnapshot se utiliza para usuarios de VPN y para sitios, y algunos de los campos solo son relevantes para usuarios o sitios.

Estos son los detalles que el campo DeviceSnapshot puede devolver para la consulta:

  • id - ID interno único de Cato para el Socket
  • name - este campo se utiliza en SiteSnapshot > Users > Devices
  • identifier - este campo se utiliza en SiteSnapshot > Users > Devices
  • connected - un valor booleano que indica si el Site está conectado a Cato Cloud
  • haRole - muestra si este es el Socket primario o secundario en modo de alta disponibilidad
  • interfaces - muestra datos en tiempo real para los enlaces WAN (tráfico saliente) (array con consultas y campos anidados)
  • lastConnected - marca de tiempo de cuando el Socket se conectó al PoP
  • lastDuration - tiempo total que el Socket ha estado conectado al PoP
  • lastPopID - el ID del PoP al que está conectado el Socket
  • lastPopName - el nombre del PoP al que está conectado el Socket
  • metrics - métricas y datos de tráfico en tiempo real para el Socket (array con consultas y campos anidados)
  • recentConnections - datos relacionados con los flujos de tráfico más recientes completados (array con consultas y campos anidados)
  • type - muestra el modelo de Socket o el tipo de vSocket
  • uptimeSeconds - tiempo total que el Socket ha estado conectado al PoP
  • socketInfo - muestra datos relacionados con el Socket, como la versión y el número de serie
  • interfacesLinkState - muestra datos en tiempo real de todos los enlaces del Socket (array con consultas y campos anidados)
  • osType - sistema operativo del Socket
  • osVersion - versión del sistema operativo del Socket
  • version - versión del Socket
  • versionNumber - versión principal del Socket
  • releaseGroup - muestra el grupo de lanzamiento del Site
  • mfaExpirationTime - este campo se utiliza en SiteSnapshot > Users > Devices

ID

El campo ID muestra el ID interno de Cato para el Socket.

Connected

El campo Connected es un valor booleano que muestra true cuando el Site está conectado a Cato Cloud.

HaRole

El campo HaRole contiene datos relacionados con el modo de alta disponibilidad para el Socket. El Socket primario está activo y el secundario es pasivo.

Interfaces

El campo Interfaces muestra datos para las interfaces WAN. El campo utiliza un array con consultas anidadas.

Para más sobre los campos Devices > Interfaces para AccountSnapshot, consulte Cato API - AccountSnapshot > Sites > Devices > Interfaces.

LastConnected

El campo LastConnected es para conexiones activas y muestra la marca de tiempo cuando el Socket inició la conexión al PoP.

LastDuration

El campo LastDuration muestra el tiempo total que el Socket está activamente conectado al PoP.

LastPopID

El Socket está conectado al PoP con este LastPopID.

LastPopName

Muestra el nombre del PoP al que está conectado el Socket.

Metrics (DeviceSnapshot)

El campo Metrics muestra las analíticas de tráfico para el Socket. Estos son los datos del Socket que puedes ver:

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

RecentConnections

El campo Device > RecentConnections muestra datos relacionados con el flujo de tráfico más reciente. Estos son los detalles que este campo puede devolver para una consulta:

  • duration - tiempo total para los datos de la consulta
  • interfaceName - Nombre del puerto en la Cato Management Application
  • deviceName - Número de serie del Socket
  • lastConnected - Muestra la marca de tiempo cuando el flujo inició la conexión al Socket
  • popID - El ID del PoP al que el flujo de tráfico estaba conectado
  • popName - El nombre del PoP al que el flujo de tráfico estaba conectado
  • remoteIP - Dirección IP del ISP para este enlace
  • remoteIPInfo - Dirección IP, ISP e información geográfica relacionada con este enlace

Recent Connections > RemoteIPInfo

El campo RecentConnections > RemoteIPInfo muestra datos relacionados con la dirección IP, ISP y ubicación física del PoP al que está conectado el enlace WAN. Estos son los detalles para los campos:

  • ip - Dirección IP de la conexión WAN al PoP
  • countryCode - código para la ubicación física del PoP (basado en geo-localización de IP)
  • countryName - país que es la ubicación física del PoP (basado en geo-localización de IP)
  • city - ciudad donde está localizado el PoP (basado en geo-localización de IP)
  • state - estado donde está localizado el PoP (basado en geo-localización de IP)
  • provider - proveedor ISP para la conexión de última milla entre Cato Cloud y el PoP
  • latitude - latitud del PoP (basado en geo-localización de IP)
  • longitude - longitud del PoP (basado en geo-localización de IP)

Tipo

El campo tipo muestra el modelo de un Socket físico o el entorno en la nube para el vSocket. Estas configuraciones se configuran en la Cato Management Application (Configuration > Site > General).

UptimeSeconds

El campo uptimeSeconds muestra el tiempo total (en segundos) que este Socket está conectado al PoP.

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 (mostrado en el Socket WebUIAbout > Device id)
  • serial - número de serie para el Socket
  • isPrimary - para configuraciones de HA, cuando este valor booleano es verdadero, este es el Socket primario
  • platform - muestra el tipo de Socket:
    • not_set - no se ha establecido plataforma para el Socket
    • VM - valor legado
    • X1 - valor legado
    • X1500 - Socket X1500
    • NATIVE - valor legado
    • X1500_BR2 - valor legado
    • X1700 - Socket X1700
    • AWS1500 - AWS vSocket
    • RPI64 - valor legado
    • AZ1500 - Azure vSocket
    • ESX1500 - VMware ESX vSocket
  • version - número de versión de hardware que está actualmente instalado en el Socket
  • versionUpdateTime - marca de tiempo cuando el Socket se actualizó a la versión actual de hardware

InterfaceLinkState

El campo interfacesLinkState muestra el estado de todos los puertos en el Socket. Los datos para esta consulta son similares a la pestaña Monitor en el Socket WebUI. Estos son los detalles que este campo puede devolver para una consulta:

  • ID - el ID para el puerto específico del Socket, por ejemplo LAN1 o LAN2
  • Up - cuando este valor booleano es verdadero, entonces el enlace para el puerto está activo
  • MediaIn - cuando este valor booleano es verdadero, entonces un cable está conectado al puerto del Socket
  • LinkSpeed - muestra el ancho de banda máximo configurado para el enlace
  • Duplex - muestra el modo dúplex para el enlace

OsType

El campo osType muestra el sistema operativo para el Socket.

OsVersion

El campo osVersion muestra la versión del sistema operativo para el Socket.

Versión

El campo versión muestra el Socket que está instalado.

VersionNumber

El campo versionNumber muestra la versión principal del Socket que está instalada.

ReleaseGroup

El campo releaseGroup muestra el grupo de lanzamiento para nuevas versiones del Socket para este Site.

¿Fue útil este artículo?

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

0 comentarios