Gestion des flux

Un flux est une entité logique créée via les API de gestion de flux. Il permet d'organiser les données de télémétrie des ressources partageant le même ensemble d'abonnements.

1. Créer un flux

2. Abonnez-vous au Stream.

3. Attachez des ressources au flux.

4. (Optionnel) Créez des règles d'alerte pour définir des conditions spécifiques de déclenchement de notifications ou d'actions en fonction des indicateurs et des données d'événements.

Limites

Les flux ont les limitations suivantes:

• Il y a une limite de 5 flux par projet.
• Vous ne pouvez joindre qu'une seule organisation à un flux.
• Vous ne pouvez joindre que 5 ressources de projet à un flux.
• Vous pouvez créer jusqu'à trois abonnements par flux. Chaque abonnement doit être destiné à un récepteur différent.
• Vous pouvez joindre 50 ressources par flux.
• Vous pouvez créer jusqu'à 50 règles d'alerte de métriques par flux.

Conditions préalables

• Pour créer des flux, vous devez disposer du rôle « Gestionnaire d'abonnements Fabric Stream » (autorisation STREAM_SUBSCRIPTION CREATE AND READ). Contactez votre administrateur d'entreprise ou votre administrateur IAM pour gérer les accès et les rôles.

• Veuillez fournir vos identifiants utilisateur, votre identifiant client et votre clé secrète client pour l'authentification OAuth2. Consultez la section Authentification API pour plus d'informations sur l'authentification de vos requêtes auprès de l'API Equinix.

Création de flux

Portal

1. Connectez-vous au [Portail client > Tableau de bord en tissu.

2. Dans le menu Observabilité, sélectionnez Flux de données.

   

3. Dans la section « Détails du flux de données », nommez votre flux. Vous pouvez aussi ajouter une description. L'« ID du projet » est automatiquement renseigné avec l'identifiant de votre projet actuel. Utilisez le Sélecteur de contexte pour changer de projet.

   

4. Cliquez sur Créer un flux de données.

API

Envoyez une requête POST au point de terminaison /fabric/v4/streams pour créer un flux.

Exemple de requête 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>"  
    }  
}'  

Exemple de réponse:

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

Affichage de vos flux

Portal

1. Connectez-vous au [Portail client > Tableau de bord en tissu.

2. Dans le menu Observabilité, sélectionnez Flux de données.

Le tableau énumère vos flux de données, leur statut, le nombre d'abonnements au flux et le nombre de ressources que vous avez ajoutées au flux.

Cliquez sur le Nom du flux pour afficher sa page Détails du flux, qui contient la description et le Journal d'activité de votre flux.

L'onglet Subscriptions contient la Liste des abonnements pour les abonnements à ce flux, et l'onglet Resources contient la Liste des ressources pour les ressources ajoutées à ce flux.

API

Pour obtenir les détails d'un flux, envoyez une requête GET au point de terminaison /fabric/v4/streams/{stream_id}.

Exemple de requête 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>'

Exemple de réponse:

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

Suppression de flux

Portal

Pour supprimer un flux, cliquez sur son nom pour voir sa page de détails. Dans le menu déroulant « Actions », cliquez sur « Supprimer le flux de données ».

Dans la boîte de confirmation, cliquez sur Oui, supprimer.

API

Pour supprimer un flux, envoyez une requête DELETE au point de terminaison /fabric/v4/streams/{stream_id}. Exemple de requête 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>'