Assinar eventos, tarefas e métricas usando um cliente MQTT

Você pode usar um cliente MQTT para assinar mensagens sobre eventos e tarefas do VMware Cloud Director.

O MQTT é um protocolo de transporte de mensagens leve e binário. O VMware Cloud Director usa MQTT para publicar informações sobre eventos e tarefas nos quais você pode assinar usando um cliente MQTT. As mensagens do MQTT passam por um agente do MQTT que também pode armazenar mensagens caso os clientes não estejam online.

Começando com o VMware Cloud Director 10.2.2, é possível usar um cliente MQTT para assinar métricas.

Pré-requisitos

Verifique se você tem um cliente MQTT que oferece suporte ao WebSocket.
Verifique se você pode adicionar cabeçalhos a uma solicitação do WebSocket atualizada.
Se quiser assinar métricas, configure a coleção de métricas e habilite a publicação de métricas. Consulte Configurar a coleção e a publicação de métricas.

Procedimento

Faça login no VMware Cloud Director usando o endpoint do OpenAPI.
Para estabelecer uma conexão WebSocket, defina a propriedade Sec-WebSocket-Protocol como mqtt, defina o cliente para se conectar ao caminho /messaging/mqtt, adicione um cabeçalho de autorização e siga o fluxo de conexão padrão do MQTT.
Você recebe o token JWT da solicitação de login padrão para o VMware Cloud Director. Você pode deixar o nome de usuário e a senha vazios.
```
Sec-WebSocket-Protocol: mqtt
```
```
Authorization: Bearer {JWT_token}
```
Quando a conexão for estabelecida com êxito, assine os tópicos por meio do cliente MQTT.
```
publish/{user_org_id}/{user_id}
```
```
publish/debd63a0-6eae-11ea-8c7b-0050561776be/d19fd8ff-6eae-11ea-bb42-0050561776c8
```
Os administradores da organização podem usar curingas para acessar todos os tópicos da organização.
```
publish/{user_org_id}/+ 
```
Os administradores do sistema podem usar curingas para acessar todos os tópicos.
```
publish/#
```
(Opcional) Para o VMware Cloud Director 10.2.2 ou versões posteriores, assine métricas.
```
metrics/{org_id}/{vApp_id}
```
Somente administradores do sistema podem acessar o tópico de métricas.