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 suas gaiolas residem. Você pode usar esta seção para monitorar essas condições.

dica

Uma zona de resfriamento é uma área do centro de dados que conta com infraestrutura mecânica comum.

dica

Para especificar se a temperatura é mostrada em Fahrenheit ou Celsius, consulte Preferências do usuário .

Dados de temperatura e umidade

Portal

Se a sua organização adquiriu sensores ambientais, você pode visualizar os dados de temperatura e umidade em nível de gabinete e gaiola nesta página.

Para visualizar 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 usina 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 próximas ao teto e áreas nas gaiolas.

• 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.

API

Se você estiver usando o API, deverá enviar um token de autenticação, consulte Autenticação do API para obter instruções.

Para visualizar dados de temperatura e umidade, envie uma GET solicitação para o /environment/v1/current endpoint. Especifique o número da 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 suportados: IBX, ZONE, CAGEou SENSOR, 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=CAGE&levelValue=<cage_id>'
-H 'Authorization: Bearer <token>'

observação

Se você não souber o código IBX, a zona ou o ID do compartimento, use o /smartview/v1/hierarchy/location ponto de extremidade para recuperar os dados da hierarquia de localização.

Dados da zona de resfriamento

Portal

Para visualizar a temperatura e a umidade em uma zona de resfriamento específica, selecione-a na lista suspensa do IBX.

observação

Essas leituras ambientais estão disponíveis apenas para gaiolas/gaiolas que possuem sensores ambientais instalados.

API

Para visualizar os dados da zona de resfriamento, envie uma GET solicitação para o /environment/v1/current endpoint. Especifique o número da 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"
}

Para filtrar ainda mais seus dados para um compartimento específico, use levelType=CAGE com o ID do compartimento como levelValue.

Exemplo de requisição 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

Alterne para a Exibição de gráfico para exibir os dados em Tendências e Tarefas em um formato gráfico.

Escolha até cinco zonas de resfriamento ou gabinetes 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 de tempo 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.

API

Para visualizar os dados ambientais de tendências, envie uma GET solicitação para o /environment/v1/trending endpoint. Especifique seu número de conta, local IBX, ponto de dados, tipo de nível, valor de nível, intervalo 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|CAGE|SENSOR>&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.