Dados ambientais
A seção Dados ambientais exibe as condições de temperatura e umidade quase em tempo real para todo o IBX e para as zonas de resfriamento onde suas cages estão localizadas. Você pode usar esta seção para monitorar essas condições.
Uma zona de resfriamento é uma área do centro de dados apoiada por uma infra-estrutura mecânica comum.
Para especificar se a temperatura é exibida em Fahrenheit ou Celsius, consulte Preferências do usuário.
Dados de temperatura e umidade
- Portal
- API
Se a sua organização adquiriu sensores ambientais, você pode visualizar os dados de temperatura e umidade no nível do gabinete e da gaiola nesta página.
Para visualizar essas informações, selecione Todas as Zonas ou uma zona específica no bloco Ambiental de um IBX no Painel de Controle.
Esta página mostra:
-
A temperatura e umidade atuais fora da IBX
-
A temperatura e umidade médias de todas as zonas de resfriamento dentro da IBX
-
A temperatura e umidade médias de todos os sensores ambientais dentro de uma zona de resfriamento
Utilizamos leituras medianas porque sensores em uma zona de resfriamento são instalados em vários locais para monitorar e gerenciar a operação da estrutura de refrigeração e a carga térmica gerada pelos equipamentos no local. Esses locais incluem retornos de ar quente, distribuição de ar frio, áreas próximas ao teto e áreas nas cages.
-
Tendências das condições ambientais em diferentes períodos de tempo, como agora em relação a ontem, agora em relação à semana passada, e agora em relação ao 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 a API, deverá enviar um token de autenticação. Consulte Autenticação da API para obter instruções.
Para visualizar dados de temperatura e umidade, envie uma solicitar GET para o endpoint /environment/v1/current. Especifique seu número de conta e informações de localização do IBX como parâmetros de consulta em sua solicitar.
Exemplo de solicitar 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 suportados: IBX, ZONE, CAGE ou SENSOR e forneça o levelValue correspondente.
Exemplo de solicitar 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>'
Se você não souber o código IBX, a zona ou o ID da cage, use o endpoint /smartview/v1/hierarchy/location para recuperar seus dados de hierarquia de localização.
Dados da zona de resfriamento
- Portal
- API
Para ver a temperatura e a umidade dentro de uma zona de resfriamento específica, escolha-a na lista suspensa no IBX.
Essas leituras ambientais só estão disponíveis para gaiolas/gabinetes que tenham sensores ambientais instalados.
Para visualizar os dados da zona de resfriamento, envie uma solicitar GET para o endpoint /environment/v1/current. Especifique o número da sua conta e as informações de localização do IBX como parâmetros de consulta na sua solicitar.
Exemplo de solicitar 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"
}
Para filtrar ainda mais seus dados para uma cage específica, use levelType=CAGE com o ID da cage como levelValue.
Exemplo de solicitar 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>'
Tendências de dados
- Portal
- API
Alterne para a Visualização em Gráfico para visualizar os dados em Tendências e Tarefas em formato gráfico.
Selecione até cinco zonas de resfriamento ou racks no filtro suspenso abaixo do gráfico para ver uma comparação gráfica das condições ambientais. O sistema sincroniza as seleções entre os dois gráficos.
Escolha um período de tempo para fazer 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 visualizar dados de comparação de 7 dias, envie uma solicitar GET para o endpoint /environmental/v1/current. Especifique o número da sua conta e as informações de localização do IBX como um parâmetro de consulta em sua solicitar.
Exemplo de solicitar 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>'
Exemplo de solicitar 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>'
Gerar relatórios
Exportar a tendência configurada de um conjunto de dados para criar um relatório. Você pode gerar um documento PDF com os 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.
Consulte Relatórios para obter detalhes de todos os relatórios gerados.