Données environnementales
La section Données environnementales affiche les conditions de température et d'humidité en temps quasi réel pour l'ensemble d'un IBX et pour les zones de refroidissement où se trouvent vos cages. Vous pouvez utiliser cette section pour surveiller ces conditions.
Une zone de refroidissement est une zone du centre de données soutenue par une infrastructure mécanique commune.
Pour spécifier si la température est affichée en Fahrenheit ou en Celsius, voir User Preferences.
Données de température et d'humidité
- Portal
- API
Si votre organisation a acheté des capteurs environnementaux, vous pouvez consulter les données de température et d'humidité au niveau de l'armoire et de la cage sur cette page.
Pour afficher ces informations, sélectionnez All Zones ou une zone spécifique dans la tuile Environmental d'un IBX sur le tableau de bord.
Cette page présente :
-
La température et l'humidité actuelles à l'extérieur de l'IBX
-
La température et l'humidité moyennes de toutes les zones de refroidissement à l'intérieur de l'IBX
-
La température et l'humidité médianes de tous les capteurs environnementaux à l'intérieur d'une zone de refroidissement.
Nous utilisons les relevés médians car les capteurs d'une zone de refroidissement sont installés à différents endroits pour surveiller et gérer le fonctionnement de la centrale de refroidissement et la charge thermique générée par l'équipement sur le site. Ces endroits comprennent les retours d'air chaud, la distribution d'air froid, les zones près du plafond et les zones dans les cages.
-
Tendances des conditions environnementales sur différentes périodes, par exemple aujourd'hui par rapport à hier, aujourd'hui par rapport à la semaine dernière et aujourd'hui par rapport au mois dernier.
-
Une option pour créer des alertes personnalisées
-
La possibilité de visualiser, de personnaliser et d'exporter une tendance de données environnementales
Si vous utilisez l'API, vous devez soumettre un jeton d'authentification, voir API Authentication pour les instructions.
Pour visualiser les données de température et d'humidité, envoyez une requête GET au point de terminaison /environment/v1/current. Spécifiez votre numéro de compte et les informations sur l'emplacement de l'IBX comme paramètres de requête dans votre demande.
Exemple de requête cURL :
curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=IBX&levelValue=<ibx_code>'
-H 'Authorization: Bearer <token>'
Pour filtrer davantage vos données, utilisez levelType avec l'une des valeurs prises en charge : IBX, ZONE, CAGE ou SENSOR, et fournissez la valeur levelValue correspondante.
Exemple de requête cURL :
curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=CAGE&levelValue=<cage_id>'
-H 'Authorization: Bearer <token>'
Si vous ne connaissez pas le code IBX, la zone ou l'ID de la cage, utilisez le point de terminaison /smartview/v1/hierarchy/location pour récupérer les données relatives à la hiérarchie de votre emplacement.
Données sur les zones de refroidissement
- Portal
- API
Pour voir la température et l'humidité dans une zone de refroidissement spécifique, choisissez-la dans la liste déroulante de l'IBX.
Ces relevés environnementaux ne sont disponibles que pour les cages/armoires équipées de capteurs environnementaux.
Pour consulter les données relatives aux zones de refroidissement, envoyez une requête GET au point de terminaison /environment/v1/current. Spécifiez votre numéro de compte et les informations sur l'emplacement de l'IBX comme paramètres de requête dans votre demande.
Exemple de requête cURL :
curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=ZONE&levelValue=<zone_id>'
-H 'Authorization: Bearer <token>'
La réponse renvoie les relevés environnementaux actuels pour l'emplacement spécifié, y compris des valeurs telles que la température, l'humidité et l'horodatage des relevés.
Exemple de réponse (tronquée) :
{
"temperature": 72.5,
"humidity": 45.2,
"timestamp": "2024-05-01T14:30:00Z"
}
Pour filtrer davantage vos données vers une cage spécifique, utilisez levelType=CAGE avec l'ID de la cage comme levelValue.
Exemple de requête cURL :
curl -X GET 'https://api.equinix.com/environment/v1/current?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=CAGE&levelValue=<cage_id>'
-H 'Authorization: Bearer <token>'
Tendances des données
- Portal
- API
Passez à Graph View pour afficher les données de Trends et Tasks dans un format graphique.
Choisissez jusqu'à cinq zones de refroidissement ou armoires dans le filtre déroulant situé sous le graphique pour obtenir une comparaison graphique de leurs conditions environnementales. Le système synchronise les sélections entre les deux graphiques.
Choisissez une période pour faire évoluer les données que vous souhaitez consulter à partir du dernier jour, de la dernière semaine ou du dernier mois. Pour personnaliser la plage de dates, utilisez le calendrier.
Pour visualiser les données de comparaison sur 7 jours, envoyez une requête GET au point de terminaison /environmental/v1/current. Spécifiez votre numéro de compte et vos informations de localisation IBX en tant que paramètre de requête dans votre demande.
Exemple de requête cURL :
curl -X GET 'https://api.equinix.com/environment/v1/trending?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=ibx&levelValue=<ibx_code>&interval=<interval>&fromDate=<epoch_timestamp_milliseconds>&toDate=<epoch_timestamp_milliseconds>'
-H 'Authorization: Bearer <token>'
Exemple de requête cURL :
curl -X GET 'https://api.equinix.com/environment/v1/trending?accountNo=<your_account_no>&ibx=<ibx_code>&levelType=cabinet&levelValue=<cabinet_id>&interval=<interval>&fromDate=<epoch_timestamp_milliseconds>&toDate=<epoch_timestamp_milliseconds>'
-H 'Authorization: Bearer <token>'
Générer des rapports
Exporter la tendance configurée d'un ensemble de données pour créer un rapport. Vous pouvez générer un document PDF à partir des données utilisées pour générer la tendance.
Créez des rapports spécifiques ou consultez tous les rapports Recently Generated, Advanced Reports, et Saved Templates dans la partie inférieure de la page.
Voir Rapports pour plus de détails sur tous les rapports générés.