Gerenciando fluxos

Um fluxo é uma entidade lógica criada por meio das APIs de gerenciamento de fluxo. Ele permite organizar dados de telemetria de ativos que compartilham o mesmo conjunto de assinaturas.

1. Crie um Stream

2. Assine o Stream.

3. Anexar ativos ao Stream.

4. (Optional) Crie regras de alerta para definir condições específicas para acionar notificações ou ações com base em métricas e dados de eventos.

Limitado

Os fluxos têm as seguintes limitações:

• Há um limite de 5 fluxos por projeto.
• Você só pode anexar uma Organização a um Stream.
• Você só pode anexar 5 ativos do projeto a um fluxo.
• Você pode criar até 3 assinaturas por Stream. Cada assinatura deve ser para um coletor diferente.
• Você pode anexar 50 ativos por fluxo.
• Você pode criar até 50 regras de alerta de métricas por fluxo.

Pré-requisitos

• Para criar fluxos, você deve ter a Fabric Stream Subscription Managerfunção (STREAM_SUBSCRIPTION PERMISSION CREATE AND READ). Entre em contato com o administrador da empresa ou o administrador do IAM para gerenciar o acesso e as funções.

• Envie suas credenciais de usuário, ID do cliente e Segredo do cliente para autenticação OAuth2. Consulte Autenticação de API para obter mais informações sobre como autenticar suas solicitações para a API da Equinix.

Criando fluxos

Portal

1. Faça login no Portal do Cliente > Painel de Fabric.

2. No menu Observabilidade, selecione Fluxos de dados.

   

3. Em Detalhes do fluxo de dados, dê um nome ao fluxo. Opcionalmente, adicione uma descrição. O Project ID é preenchido automaticamente com o ID do projeto atual. Use o Context Switcher para alterar projetos.

   

4. Clique em Criar fluxo de dados.

API

Envie uma POST solicitação para o /fabric/v4/streams endpoint para criar um Stream.

Solicitação de ondulação de amostra:

curl -X 'POST' 'https://api.equinix.com/fabric/v4/streams' \  
-H 'Content-Type: application/json' \  
-H 'Authorization: Bearer <Bearer Token>' \  
-d '{  
    "type": "TELEMETRY_STREAM",  
    "name": "splunk1",  
    "description": "subscription 1",  
    "project": {
        "projectId": "<projectId>"  
    }  
}'  

Resposta da amostra:

{  
    "uuid": "241372e9-79c9-4ef8-b77a-8b8176c2098b4",  
    "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4",  
    "type": "TELEMETRY_STREAM",  
    "name": "splunk1",  
    "description": "subscription 1",  
    "project": {  
        "projectId": "<projectId>"  
    },  
    "enabled": true,  
    "state": "PROVISIONING",  
    "assetsCount": 0,  
    "streamSubscriptionsCount": 0,  
    "changelog": {  
        "createdBy": "testuser",  
        "createdDateTime": "2024-08-12T21:14:17.689103902Z"  
    }  
}

Visualizando suas transmissões

Portal

1. Faça login no Portal do Cliente > Painel de Fabric.

2. No menu Observabilidade, selecione Fluxos de dados.

A tabela lista seus fluxos de dados, seu status, quantas assinaturas existem no fluxo e quantos recursos você adicionou ao fluxo.

Clique em um Stream Name para visualizar sua página Stream Details, que contém a descrição do fluxo e o Activity Log.

A guia Subscriptions contém a Lista de assinaturas para assinaturas deste fluxo, e a guia Resources contém a Lista de recursos para os recursos adicionados a este fluxo.

API

Para obter os detalhes de um Stream, envie uma GET solicitação para o /fabric/v4/streams/{stream_id} endpoint.

Solicitação de ondulação de amostra:

curl -X 'GET' 'https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4' \  
-H 'Content-Type: application/json' \  
-H 'Authorization: Bearer <Bearer Token>'

Resposta da amostra:

{  
    "href": "https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c228b4",
    "uuid": "241372e9-79c9-4ef8-b77a-8b8176c2098b4",  
    "type": "STREAM_SUSBSCRIPTION",  
    "name": "splunk1",  
    "description": "subscription 1",  
    "project": {  
        "projectId": "<projectId>"  
    },  
    "enabled": true,  
    "state": "PROVISIONED",  
    "changelog": {  
        "createdBy": "testuser",  
        "createdDateTime": "2024-08-12T21:14:17.689104Z"  
    }  
}

Excluindo transmissões

Portal

Para excluir um fluxo, clique em um Stream Name para visualizar sua página Stream Details. No menu suspenso Actions, clique em Excluir fluxo de dados.

Na caixa de confirmação, clique em Sim, Excluir.

API

Para excluir um fluxo, envie uma DELETE solicitação para o /fabric/v4/streams/{stream_id} endpoint. Solicitação de ondulação de amostra:

curl -X 'DELETE' 'https://api.equinix.com/fabric/v4/streams/241372e9-79c9-4ef8-b77a-8b8176c2098b4' \  
-H 'Content-Type: application/json' \  
-H 'Authorization: Bearer <Bearer Token>'