Dados ambientais
A seção de dados ambientais exibe as condições de temperatura e umidade quase em tempo real para um IBX inteiro e para as zonas de resfriamento onde seus cages residem. Você pode usar esta seção para monitorar essas condições.
Uma zona de resfriamento é uma área do centro de dados que conta com infraestrutura mecânica comum.
Para especificar se a temperatura é mostrada em Fahrenheit ou Celsius, consulte Preferências do usuário .
Dados de temperatura e umidade
- Portal
- API
Para ver essas informações, selecione Todas as zonas ou uma zona específica no bloco Ambiente de um IBX no Painel.

Esta página mostra:
-
A temperatura e a umidade atuais fora do IBX.
-
A temperatura e a umidade médias de todas as zonas de refrigeração dentro do IBX.
-
A temperatura e a umidade médias de todos os sensores ambientais dentro de uma zona de resfriamento.
Usamos leituras medianas porque sensores em uma zona de resfriamento são instalados em vários locais para monitorar e gerenciar a operação da planta de resfriamento e a carga de calor gerada pelo equipamento no local. Esses locais incluem retornos de ar quente, distribuição de ar frio, áreas perto do teto e áreas nas cages.
-
Tendências das condições ambientais em diferentes períodos de tempo, como agora em comparação com ontem, agora em comparação com a semana passada e agora em comparação com o mês passado.
-
Uma opção para criar alertas personalizados.
-
A capacidade de visualizar, personalizar e exportar uma tendência de dados ambientais.

Se você estiver usando o API, deverá enviar um token de autenticação; consulte Autenticação API para obter instruções.
Para ver dados de temperatura e umidade, envie uma GET solicitação para o /environment/v1/current terminal. Especifique o número da sua conta e as informações de localização do IBX como parâmetros de consulta na solicitação.
Exemplo de requisição 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>'
Para filtrar ainda mais seus dados, use levelType com um dos valores aceitos: IBX ou ZONE, e forneça a correspondência levelValue.
Exemplo de requisição 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>'
Se você não souber o código IBX, a zona ou o ID do cage, use o /smartview/v1/hierarchy/location terminal para recuperar os dados da hierarquia de localização.
Dados da zona de resfriamento
- Portal
- API
Para visualizar a temperatura e a umidade em uma zona de resfriamento específica, selecione-a na lista suspensa do IBX.

Para ver os dados da zona de resfriamento, envie uma GET solicitação para o /environment/v1/current terminal. Especifique o número da sua conta e as informações de localização do IBX como parâmetros de consulta na solicitação.
Exemplo de requisição 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>'
A resposta retorna as leituras ambientais atuais para o local especificado, incluindo valores como temperatura, umidade e o registro de data e hora da leitura.
Exemplo de resposta (truncada):
{
"temperature": 72.5,
"humidity": 45.2,
"timestamp": "2024-05-01T14:30:00Z"
}
Tendências de dados
- Portal
- API
Mude para a Visualização de gráfico para ver os dados em Tendências e tarefas em um formato gráfico.

Escolha até cinco zonas de resfriamento ou racks no filtro suspenso abaixo do gráfico para ver uma comparação gráfica de suas condições ambientais. O sistema sincroniza as seleções entre os dois gráficos.
Escolha um período para definir a tendência dos dados que você deseja visualizar do último dia, semana ou mês. Para personalizar o intervalo de datas, use o calendário.
Para ver os dados ambientais de tendências, envie uma GET solicitação para o /environment/v1/trending terminal. Especifique o número da sua conta, local IBX, ponto de dados, tipo de nível, valor do nível, e intervalo de datas como parâmetros de consulta em sua solicitação.
Exemplo de requisição cURL:
curl -X GET 'https://api.equinix.com/environment/v1/trending?accountNo=<your_account_no>&ibx=<ibx_code>&dataPoint=<temperature|humidity>&levelType=<IBX|ZONE>&levelValue=<level_value>&interval=<interval>&fromDate=<ISO8601_datetime>&toDate=<ISO8601_datetime>'
-H 'Authorization: Bearer <token>'
Gerar relatórios
Exporte a tendência configurada de um conjunto de dados para criar um relatório. Você pode gerar um documento PDF a partir dos dados usados para gerar a tendência.
Crie relatórios específicos ou visualize todos os relatórios gerados recentemente, Relatórios Avançados e Modelos salvos na seção inferior da página.
