# Integração com um coletor O API de assinatura permite estabelecer um destino de canal de comunicação para eventos relacionados ao status ambiental e operacional de ativos selecionados. Ele suporta os canais de comunicação AWS IoT Core, Hub de Eventos do Azure e Webhook. > **Observação** > > Você também pode criar uma assinatura e acessar seus dados no Equinix API. Consulte [Transmitir dados Colocation do Equinix API](https://docs.equinix.com/pt-BR/smart-view/sv-api/getoperatinginformation.md) para obter instruções. ## Certificado mTLS da Equinix[​](#certificado-mtls-da-equinix "Link direto para Certificado mTLS da Equinix") O certificado MTLS é usado como uma extensão do certificado TLS (antigo SSL) para que o servidor e o cliente autentiquem um ao outro. A Equinix requer esse certificado assinado confiável dos clientes, semelhante ao fornecido por nossos serviços. Nossos serviços de assinatura oferecem a opção adicional de verificação de conexão. Quando um novo lote de eventos é enviado com cada tentativa de comunicação, nossos serviços de assinatura usam os certificados fornecidos pelo cliente para validar se o serviço para o qual estamos enviando os dados é o correto. Para recuperar o certificado, envie uma `GET` solicitação ao [`/smartview/v2/streaming/subscriptions/certificate`](https://docs.equinix.com/pt-BR/api-catalog/smartviewv2/streaming-subscription-api/getcertificate.md)terminal. Especifique o destino do canal como um parâmetro de consulta, `AWS_IOT_CORE`ou `WEBHOOK`. Exemplo de solicitação cURL: ``` curl -X 'GET' 'https://api.equinix.com/smartview/v2/streaming/subscriptions/certificate?channelType=WEBHOOK' \ -H 'Authorization: Bearer ' ``` > **Importante** > > O API de assinatura não aceita certificados autoassinados. Use um certificado CA para autenticação mútua. ## AWS IoT[​](#aws-iot "Link direto para AWS IoT") Envie dados para o AWS IoT Core fornecendo o [terminal HTTP](https://docs.aws.amazon.com/iot/latest/developerguide/http.html) ao [criar sua assinatura](https://docs.equinix.com/pt-BR/smart-view/sv-api/create-subscription.md#aws-iot-core). > **Observação** > > Para autorizar a Equinix a enviar eventos para um destino AWS IoT Core, você deve baixar o [Certificado Equinix](#equinix-mtls-certificate) e registrá-lo no console do IoT Core. Consulte [a documentação do AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/manual-cert-registration.html) para obter instruções. ## Hub de Eventos do Azure[​](#hub-de-eventos-do-azure "Link direto para Hub de Eventos do Azure") A configuração de autoatendimento para enviar dados para o Hub de Eventos do Azure não está disponível. Para ativar o envio para dados para o Azure, [contate o suporte](https://docs.equinix.com/pt-BR/customer-support/opening-support-case.md). ## Webhooks[​](#webhooks "Link direto para Webhooks") Se você não deseja usar o AWS ou o Azure como coletor, mas pode fornecer um URL de destino para o qual os dados de streaming podem ser enviados, a Equinix oferece [a criação de uma assinatura para enviar dados para um destino webhook genérico](https://docs.equinix.com/pt-BR/smart-view/sv-api/create-subscription.md#webhook) . ## Formatos de objetos para coletores[​](#formatos-de-objetos-para-coletores "Link direto para Formatos de objetos para coletores") O formato da mensagem para os canais do AWS IoT Core e Hubs de Eventos do Azure torna as mensagens mais legíveis. Aqui estão alguns exemplos de mensagens que são enviadas por meio de assinaturas do API Plus. ### Ambiental - temperatura[​](#ambiental---temperatura "Link direto para Ambiental - temperatura") ``` { "type": "environmental", "data": { "ibx": "CH2", "asset": { "id": "asset1", "level": "ZONE" }, "reading": { "value": "23.300", "unit": "CELSIUS" }, "tag": { "id": "temperature", "displayName": "Temperature" }, "readingTime": "2020-08-24T09:21:00.000Z" } } ``` ### Umidade ambiental[​](#umidade-ambiental "Link direto para Umidade ambiental") ``` { "type": "environmental", "data": { "ibx": "CH1", "asset": { "id": "asset1", "level": "ZONE" }, "reading": { "value": "66.120", "unit": "PERCENT" }, "tag": { "id": "humidity", "displayName": "Humidity" }, "readingTime": "2020-07-28T12:35:14.615Z" } } ``` ### Energia[​](#energia "Link direto para Energia") ``` { "type": "power", "data": { "ibx": "SP2", "asset": { "id": "0210:469593", "type": "CIRCUIT" }, "cage": "ssxxxxsss", "cabinet": "SP2:01:021470:0210", "accountNumber": "1000659151", "realPower": { "value": "0.522", "unit": "kW" }, "apparentPower": { "value": "1.070", "unit": "kVA" }, "contractualPower": { "value": "60.000", "unit": "kVA" }, "current": { "value": "1.500", "unit": "A" }, "powerFactor": { "value": "0.48", "unit": "pf" }, "soldCurrent": { "value": "15.000", "unit": "A" }, "soldPower": { "value": "2.880", "unit": "kVA" }, "powerConsumptionToContractual": { "value": "32.151", "unit": "PERCENT" }, "cabinetRating": { "value": "123.300", "unit": "kVA" }, "peakLastSevenDays": { "value": "1.146", "unit": "kVA" }, "peakLastSevenDaysRatio": { "value": "34.424", "unit": "PERCENT" }, "peakLastSevenDaysContractualPower": { "value": "3.329", "unit": "kVA" }, "peakLastSevenDaysTime": "2020-07-29T07:00:00.000Z", "lastUpdated": "2020-07-24T11:46:00.000Z", "readingTime": "2020-07-24T11:45:00.000Z", "description": "test description", "oid": "1.3.6.1.2.1.299.2.10.6846", "circuitType": "primary", "customerName": "test customer" } } ``` ### Potência medida - kWh[​](#potência-medida---kwh "Link direto para Potência medida - kWh") ``` { "type": "metered-power", "data": { "ibx": "LD9", "asset": { "id": "LD9.CBM-PDU-17-99", "type": "Customer Billing Meter" }, "cage": "LD9:0G:00Z13Z", "cageSerialNo": "00Z13B-21010567", "accountNumber": "1000006212", "customerName": "ABC Company", "kilowattHour": { "value": "304574.323", "unit": "kWh" }, "readingTime": "2023-04-24T11:45:00.000Z", "dataQuality": "Good" } } ``` Nota: As leituras de potência medida estão disponíveis em kWh, kW, kVA, A e pf (fator de potência). ### Ponto de identificação[​](#ponto-de-identificação "Link direto para Ponto de identificação") ``` { "type": "tag-point", "data": { "ibx": "LA1", "reading": { "value": "33406.6", "unit": "l/s" }, "tag": { "id": "LA1.Air-Handler-7-4-4:totalsupplyairflow", "displayName": "Total Supply Air Flow" }, "readingTime": "2020-08-24T09:21:00.000Z" } } ``` ### Alerta personalizado[​](#alerta-personalizado "Link direto para Alerta personalizado") ``` { "type": "alert", "data": { "ibx": "SG2", "region": "APAC", "asset": { "id": "CH1.Colo.CH1_05_000550_0105", "type": "ENVIRONMENTAL", "classification": "Environmental" }, "tag": { "id": "temperature" }, "threshold": { "unit": "CELSIUS", "maxValue": "-6.67", "minValue": "-12.22" }, "id": "zhe-15603221441540.3171591127612322145", "triggeredTime": "2019-09-23T23:01:30.655Z", "type": "environmental", "typeId": "Absolute", "conditional": "N", "eventType": "Out of Range", "heartbeat": false } } ``` ### Alerta do sistema[​](#alerta-do-sistema "Link direto para Alerta do sistema") ``` { "type": "system-alert", "data": { "ibx": "SG2", "region": "APAC", "metro": "SG", "country": "SG", "currentValue": { "unit": "kWh", "value": "2.650479E7", "type": "float" }, "asset": { "id": "9SG2.ELEC4AUPSR-A10ASBF0", "type": "Circuit Breaker with Metering", "classification": "Electrical" }, "tag": { "id": "SG2.ELEC5BUPSR-B14UAH2Q:breaker", "displayName": "Bypass Not Available" }, "conditionName": "Low", "status": { "acknowledged": true, "acknowledgementTime": "2020-07-28T12:35:14.615Z", "cleared": false, "active": false }, "threshold": { "unit": "kWh", "stateLimit": "80", "message": "Drive not in Auto" }, "severity": 820, "triggeredTime": "2020-07-28T12:35:14.615Z", "processedTime": "2020-07-28T12:35:14.615Z", "normalProcessedTime": "2020-07-28T12:35:14.615Z", "normalTriggeredTime": "2020-07-28T12:35:14.615Z", "type": "Digital", "heartbeat": false } } ``` ### Indicadores de Qualidade de Dados[​](#indicadores-de-qualidade-de-dados "Link direto para Indicadores de Qualidade de Dados") O campo `dataQuality` oferece os Indicadores de Qualidade de Dados (DQI) de pontos de dados e alertas (sistema e personalizado) como parte dos próprios dados. Isso é usado para garantir e informar ao cliente API que os dados dos ativos DCIM são válidos e coletados de forma confiável. A adição do DQI fornece transparência em relação à qualidade dos dados recebidos. ### Indicadores de armazenamento e encaminhamento[​](#indicadores-de-armazenamento-e-encaminhamento "Link direto para Indicadores de armazenamento e encaminhamento") O campo `messageRetried`SNFI (Store and Forward Indicator, indicador de armazenamento e encaminhamento) é usado para se comunicar se os dados do DCIM estiverem realmente quase em tempo real ou atrasados e enviados posteriormente devido a uma conexão interrompida pelo canal NRT. Se a conexão entre o cliente de assinatura e o editor tiver um problema, o editor usará o mecanismo Armazenar e encaminhar (SNF) para armazenar a mensagem no lado do editor. Quando a conexão é restabelecida, essas mensagens armazenadas e eventos NRT são enviados ao cliente após o tempo de conexão estabelecido. Os dados enviados posteriormente por causa do método SNFI são marcados, pois não são mais dados NRT, em comparação com outros dados normais. Suas aplicações de API podem criar regras de negócios e tomar decisões com base nesses dois indicadores para melhorar a transparência dos dados e a eficiência da solução. ``` { "messageRetried": true, "type": "tag-point", "data": { "ibx": "SG2", "reading": { "value": "54.0", "unit": "s" }, "tag": { "id": "SG2.UPS-5-RM A22-04:batterytimeremaining", "displayName": "Battery Time Remaining" }, "readingTime": "2021-03-25T03:48:00.510Z", "dataQuality": "Good" } } ``` ## Interpretando valores ENUM e booleanos[​](#interpretando-valores-enum-e-booleanos "Link direto para Interpretando valores ENUM e booleanos") Poderá ser fornecida uma planilha do Excel que inclua colunas semelhantes às seguintes: | IBX | TIPO\_DE\_ATIVO | CLASSIFICAÇÃO\_DE\_ATIVOS | ID\_DO\_ATIVO | SUFIXO\_DE\_TAG | ID\_DA\_TAG | TIPO\_DE\_DADOS\_TAG | TAG\_UOM | NOME\_DE\_EXIBIÇÃO\_DA\_TAG | NOME\_DA\_TABELA\_DE\_ESTADOS | | --- | ---------------------------- | ------------------------- | --------------------------- | ------------------- | --------------------------------------- | -------------------- | -------- | --------------------------- | ----------------------------- | | TR5 | Incêndio, Detecção de fumaça | Mecânico | TR5.Alarme de Incêndio\_001 | alarme | TR5.Alarme de Incêndio\_001:alarme | Bool | | Alarme | ALARME NORMAL | | TR5 | Detecção de vazamento | Mecânico | TR5.LD\_TR5\_CABLE1 | vazamento detectado | TR5.LD\_TR5\_CABLE1:vazamento detectado | Bool | | Vazamento detectado | ALARME NORMAL | | TR5 | UPS | Elétrico | TR5.UPS\_2110 | resiliente | TR5.UPS\_2110:resiliente | Bool | | Resiliente | REDUCEDRESIL\_RESILASDESIGNED | Para valores booleanos e ENUM, consulte `STATE_TABLE_NAME`quando o primeiro valor (`NORMAL`, `REDUCEDRESIL`) corresponder a `0`, e o segundo valor (`ALARM`, `RESILASDESIGNED`) corresponder a `1`. ## frequência de chamadas à API[​](#frequência-de-chamadas-à-api "Link direto para frequência de chamadas à API") Para o Power API, ligue para o departamento de TI a cada 5 minutos para data centers da Ásia-Pacífico e a cada 15 minutos para outras regiões. O limite é de 100 000 chamadas por usuário por dia. Para o API de assinaturas (método de coleta REST), ligue-o aproximadamente a cada 30 segundos por ID de assinatura. Ligar até uma vez a cada 5 minutos é suficiente.