Cato API - AccountMetrics > Sites > Interfaces

AccountMetrics > Sites > Interfaces

Les champs AccountMetrics > Sites > Interfaces contiennent des données relatives aux liaisons WAN Socket pour un site.

Champs InterfaceMetrics

Les champs InterfaceMetrics contiennent des données pour les liaisons WAN de Socket. Voici les détails et les champs de la requête :

  • métriques - données de trafic pour le lien (tableau avec champs imbriqués)
  • nom - nom du lien dans l'application de gestion Cato
  • série temporelle - période pour les données et définit la relation entre les conteneurs et les données (tableau avec requêtes et champs imbriqués)
  • annotations - annotation d'horodatage qui montre un incrément de temps pour une interface graphique (tableau avec requêtes et champs imbriqués)
  • périodes - objet qui est une durée de temps spécifique (tableau avec champs imbriqués)
  • info (SocketInterface) - data related to the link, such as Gateway IP address (array with nested fields)
  • remoteIPinfo - data related to the link IP address, such as country code (array with nested fields)
  • remoteIP - adresse IP du FAI pour ce lien
  • socketInfo - données relatives aux sites Socket et vSocket, telles que le numéro de série et la version de Socket (tableau avec champs imbriqués)
  • ipsecInfo - données relatives aux sites IPsec, telles que la version IKE (tableau avec champs imbriqués)
  • interfaceInfo - informations de configuration de base concernant l'interface Socket (tableau avec champs imbriqués)

Métriques (InterfaceMetrics)

The Metrics field shows the traffic analytics for the WAN links. Voici les détails pour les champs :

  • durée - quantité totale de temps pour les données de Socket
  • granularité - durée en secondes pour un conteneur de métriques unique
  • bytesDownstream - trafic total descendant (de la Cato Cloud vers le Socket)
  • bytesUpstream - trafic total montant (du Socket vers la Cato Cloud)
  • bytesTotal - trafic total pour le Socket
  • lostDownstream - nombre de paquets perdus pour le trafic descendant
  • lostDownstreamPourcent - pourcentage de paquets perdus pour le trafic descendant
  • lostUpstream - nombre de paquets perdus pour le trafic montant
  • lostUpstreamPourcent - pourcentage de paquets perdus pour le trafic montant
  • packetsDownstream - total de paquets descendants
  • packetsUpstream - total de paquets montants
  • gigueMontante - gigue pour le trafic montant (différence de délai en millisecondes (ms) entre les paquets de données)
  • gigueDescendante - gigue pour le trafic descendant (différence de délai en millisecondes (ms) entre les paquets de données)
  • paquetsRejetésDescendants - total des paquets rejetés pour le trafic descendant
  • paquetsRejetésMontants - total des paquets rejetés pour le trafic montant
  • délaiAllerRetour - temps de trajet aller-retour du Socket à la Cato Cloud

toRate Argument

Lorsque l'argument booléen toRate est défini sur true, les données sont renvoyées par seconde. Lorsque l'argument est défini sur false, la requête renvoie les données sur toute la période de temps.

L'argument toRate ne s'applique qu'aux types avec des données en octets, il ne s'applique pas à rtt, health, etc.

Nom

The Name field show the name for the link that is configured in the Cato Management Application (Configuration > Sites > Socket Configuration).

Séries temporelles

Les champs de séries temporelles InterfaceMetrics montrent les métriques pour le lien selon la période spécifiée (conteneurs) dans la requête. Inclut des statistiques et des métriques historiques et en quasi-temps réel.

Les détails pour les champs et arguments de séries temporelles InterfaceMetrics sont les mêmes que ceux des séries temporelles AccountMetrics, voir Cato API - AccountMetrics > Séries temporelles.

Annotations

Les champs et arguments Annotations montrent des événements spécifiques selon l'heure et le type d'événement. Voici les détails pour les champs :

  • temps - horodatage de l'événement
  • étiquette - description de l'événement
  • courteÉtiquette - brève description de l'événement
  • type - type d'événement
    • changementPop - le site se connecte à un PoP différent
    • roleChange - change for HA status role
    • changementIPDistant - l'adresse IP du FAI (IP distante) a changé
    • générique - autres événements inclus dans les annotations

Argument Types d'Annotations

Specify the event type that is included in the query: popChange, roleChange, or generic.

Périodes

Les champs Périodes montrent les métriques de TypePériode pour la durée de temps spécifiée. Voici les détails pour les champs :

  • duration - A tuple of two numbers that represent the start and endtime (in ms) according to the index for the starting and ending bucket index
  • titre - Étiquette décrivant les métriques
  • type - Un tableau énumérant qui identifie le type de données pour cette période :
    • pertePaquet- perte de paquets due à un problème de connectivité
    • donnéesManquantes - pas de données disponibles pour la période
    • lienPassif - le lien est en mode veille et ne passe pas de trafic
    • actif - le lien est en charge active et passe du trafic
    • débordé - certains paquets ont été mis en file d'attente et envoyés après un délai
    • congestionné - certains paquets ont été rejetés car ils ont expiré dans la file d'attente
    • pertePaquetDerniereMile - perte de paquets mesurée entre le Socket et le PoP
    • latenceDerniereMile - latence mesurée entre le Socket et le PoP
    • générique - quelque chose a affecté le lien de manière inconnue
    • pop - PoP spécifique auquel le lien est actuellement connecté

remoteIPInfo

Les champs remoteIPInfo montrent les données que l'adresse IP pour le lien. Voici les détails pour les champs liés à l'adresse IP :

  • ip - IP address of the link
  • countryCode - Geolocation ISO country code
  • nomPays - nom de pays géolocalisation
  • ville - ville de géolocalisation
  • état - état de géolocalisation
  • provider - ISP Internet provider
  • latitude - latitude de géolocalisation pour le FAI
  • longitude - longitude de géolocalisation pour le FAI

remoteIP

The remoteIP field shows the IP address of the link, without the extra data from remoteIPInfo.

socketInfo

Le champ socketInfo montre les données sur le Socket, comme le numéro de version et le numéro de série. Voici les détails pour les champs :

  • id - ID unique pour le Socket
  • série - numéro de série pour le Socket
  • isPrimary - for HA configurations, when this boolean value is true, this the primary Socket
  • plateforme - Montre le type de Socket :
    • non_défini - aucune plateforme définie pour le Socket
    • VM - valeur héritée
    • X1 - valeur héritée
    • X1500 - Socket X1500
    • NATIVE - valeur héritée
    • X1500_BR2 - à déterminer
    • X1700 - Socket X1700
    • AWS1500 - AWS vSocket
    • RPI64 - valeur héritée
    • AZ1500 - Azure vSocket
    • ESX1500 - VMware ESX vSocket
  • version - numéro de version logicielle actuellement installé sur le Socket
  • versionUpdateTime - horodatage lorsque le Socket a été mis à niveau vers la version matérielle actuelle

ipsecInfo

Le champ ipsecInfo montre les données sur les paramètres de connexion pour le site IPsec. Voici les détails pour les champs :

  • isPrimary - for HA configurations, when this boolean value is true, this the primary IPsec firewall or routing device
  • catoIP - The source IP address for the IPsec tunnel in the Cato Cloud
  • remoteIP - l'adresse IP de destination pour le tunnel IPsec (dans le site)
  • ikeVersion - montre 1 pour IKEv1 et 2 pour IKEv2

interfaceInfo

The interfaceInfo fields contains data related to a Socket ports for a site that are configured in the Cato Management Application (Configuration > Sites > Socket Configuration). Voici les détails pour les champs :

  • id - ID for the Socket port in the Socket WebUI Monitor tab
  • nom - nom pour le port dans l'application de gestion Cato
  • bandePassanteMontante - bande passante maximale autorisée sur ce port, pour le trafic du site vers le Cato Cloud
  • bandePassanteDescendante - bande passante maximale autorisée pour le trafic sur ce port, du Cato Cloud vers le site

Cet article vous a-t-il été utile ?

Utilisateurs qui ont trouvé cela utile : 1 sur 1

0 commentaire