Gerenciando fluxos

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

1. Criar um fluxo

2. Inscreva-se no Stream.

3. Anexe ativos ao Stream.

4. (Opcional) 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.

Limitações

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

• Há um limite de 5 transmissões por Projeto.
• Você só pode anexar uma Organização a um Fluxo.
• Você só pode anexar 5 ativos de 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 Stream.
• Você pode criar até 50 Regras de Alerta de Métricas por Fluxo.

Pré-requisitos

• Para criar fluxos, você precisa ter a função Fabric Stream Subscription Manager (STREAM_SUBSCRIPTION PERMISSION CREATE AND READ). Entre em contato com o administrador da sua empresa ou com o administrador do IAM para gerenciar acesso e 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 à API da Equinix.

Criando Streams

Portal

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

2. No menu Observabilidade, selecione Fluxos de Dados.

   

3. Nos Detalhes do Fluxo de Dados, dê um nome ao seu fluxo. Opcionalmente, adicione uma descrição. O ID do Projeto é preenchido automaticamente com o ID do seu projeto atual. Use o Alternador de Contexto para trocar de projeto.

   

4. Clique em Criar fluxo de dados.

API

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

Exemplo de solicitar cURL:

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>"  
    }  
}'  

Exemplo de resposta:

{  
    "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 seus streams

Portal

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

2. No menu Observabilidade, selecione Fluxos de Dados.

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

Clique no Nome da Transmissão para visualizar a página de Detalhes da Transmissão, que contém a descrição da sua transmissão e o Registro de Atividades.

A aba Assinaturas contém a Lista de Assinaturas para assinaturas deste fluxo, e a aba Recursos contém a Lista de Recursos para os recursos adicionados a este fluxo.

API

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

Exemplo de solicitação cURL:

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>'

Exemplo de resposta:

{  
    "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 Streams

Portal

Para excluir um fluxo, clique no Nome do Fluxo para visualizar a página de Detalhes do Fluxo. No menu suspenso Ações, clique em Excluir Fluxo de Dados.

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

API

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

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>'