Scénario : envoi de mesures à Object Storage

Découvrez comment envoyer des mesures à un bucket dans Object Storage à l'aide de Connector Hub.

Stratégie IAM requise

Si vous êtes membre du groupe d'administrateurs, vous disposez déjà de l'accès requis pour réaliser ce scénario. Sinon, vous devez disposer d'un accès en lecture aux mesures dans les compartiments indiqués.

Le workflow de création d'un connecteur avec une source Monitoring inclut une stratégie par défaut de lecture à partir de Monitoring dans les compartiments sélectionnés. Si vous ne connaissez pas les stratégies, reportez-vous à Présentation des stratégies IAM.

Objectif

L'objectif de ce scénario est d'archiver les données de mesures des instances de calcul et des volumes de blocs dans un bucket Object Storage. Dans ce scénario, les ressources se trouvent dans deux compartiments. Vous allez donc sélectionner des mesures dans les deux compartiments.

Configuration de ce scénario

La configuration de ce scénario implique la création d'un connecteur pour déplacer les mesures d'instance de calcul et de volume de blocs (espaces de noms de mesure oci_computeagent et oci_blockstore) vers un bucket. Toutes les mesures de ces espaces de noms sont incluses.

Vous pouvez effectuer ces tâches dans l'interface de ligne de commande, l'API ou la console Oracle Cloud Infrastructure.

    1. Sur la page de liste Connecteurs, sélectionnez Créer un connecteur. Si vous avez besoin d'aide pour trouver la page de liste, reportez-vous à Liste des connecteurs.
    2. Sur la page Créer un connecteur, entrez un nom convivial pour le nouveau connecteur et une description facultative. Evitez de saisir des informations confidentielles.
      Exemple : "Metrics to Bucket"
    3. Pour Compartiment de ressource, sélectionnez le compartiment dans lequel stocker le nouveau connecteur.
    4. Sous Configurer un connecteur, sélectionnez les services source et cible pour déplacer les données de journal vers une mesure :
      • Source : Surveillance
      • Cible : Object Storage
    5. Sous Configurer la source, sélectionnez les mesures d'instance de calcul et de volume de blocs dans chaque compartiment :
      1. Compartiment de mesures : premier compartiment contenant les instances de calcul et les volumes de blocs pour lesquels vous voulez des mesures.

      2. Espaces de noms : sélectionnez oci_computeagent et oci_blockstore.

      3. Sélectionnez + Un autre compartiment pour ajouter le deuxième compartiment.

      4. Compartiment de mesures : deuxième compartiment contenant les instances de calcul et les volumes de blocs pour lesquels vous voulez des mesures.

      5. Espaces de noms : sélectionnez oci_computeagent et oci_blockstore.

    6. Ignorez la tâche facultative (Configurer la tâche).
    7. Sous Configurer la cible, sélectionnez le bucket vers lequel déplacer les mesures :
      • Sélectionnez le compartiment contenant le bucket.
      • Sélectionnez le bucket souhaité.
    8. Acceptez les stratégies par défaut : sélectionnez le lien Créer fourni pour chaque stratégie par défaut.
    9. Sélectionnez Créer.

    Le processus de création commence et sa progression s'affiche. Une fois l'opération terminée, la page de détails du connecteur s'ouvre. Le nouveau connecteur commence immédiatement à déplacer les mesures vers le bucket sélectionné. Les mesures sont contenues dans les objets du bucket.

    1. Définissez la source de surveillance pour le connecteur : enregistrez un fichier nommé source.json.

      Exemple de fichier source.json
      {
        "kind": "monitoring",
        "monitoringSources": [
          {
            "compartmentId": "<first_compartment_OCID>",
            "namespaceDetails": {
              "kind": "selected",
              "namespaces": [
                {
                  "namespace": "oci_computeagent",
                  "metrics": {
                    "kind": "all"
                  }
                },
                {
                  "namespace": "oci_blockstore",
                  "metrics": {
                    "kind": "all"
                  }
                }
              ]
            }
          },
          {
            "compartmentId": "<second_compartment_OCID>",
            "namespaceDetails": {
              "kind": "selected",
              "namespaces": [
                {
                  "namespace": "oci_computeagent",
                  "metrics": {
                    "kind": "all"
                  }
                },
                {
                  "namespace": "oci_blockstore",
                  "metrics": {
                    "kind": "all"
                  }
                }
              ]
            }
          }
        ]
      }
    2. Définissez la cible Object Storage du connecteur : enregistrez un fichier nommé target.json.

      Exemple de fichier target.json
      {
        "kind": "objectStorage",
        "bucketName": "<bucket_name>",
        "objectNamePrefix": "<prefix>"
      }
    3. Créez le connecteur à l'aide de la commande oci sch service-connector create :

      Exemple de commande pour la création d'un connecteur
      oci sch service-connector create
       --compartment-id <compartment_OCID>
       --display-name "Metrics to Bucket"
       --source file://source.json
       --target file://target.json

      Pour obtenir la liste complète des paramètres et des valeurs des commandes d'interface de ligne de commande, reportez-vous à Référence de commande d'interface de ligne de commande.

      Pour plus d'informations sur le dépannage, reportez-vous à la section Troubleshooting Connectors et à la section Troubleshooting Notifications.

    Afin d'obtenir la liste complète des indicateurs et des options de variable pour les commandes d'interface de ligne de commande, reportez-vous à Référence de ligne de commande.

  • Utilisez l'opération CreateServiceConnector pour créer le connecteur.

    Exemple de demande CreateServiceConnector
    POST /20200909/serviceConnectors
    Host: service-connector-hub.us-phoenix-1.oraclecloud.com
    <authorization and other headers>
    {
      "compartmentId": "<compartment_OCID>",
      "displayName": "Metrics to Bucket",
      "source": {
        "kind": "monitoring",
        "monitoringSources": [
          {
            "compartmentId": "<first_compartment_OCID>",
            "namespaceDetails": {
              "kind": "selected",
              "namespaces": [
                {
                  "namespace": "oci_computeagent",
                  "metrics": {
                    "kind": "all"
                  }
                },
                {
                  "namespace": "oci_blockstore",
                  "metrics": {
                    "kind": "all"
                  }
                }
              ]
            }
          },
          {
            "compartmentId": "<second_compartment_OCID>",
            "namespaceDetails": {
              "kind": "selected",
              "namespaces": [
                {
                  "namespace": "oci_computeagent",
                  "metrics": {
                    "kind": "all"
                  }
                },
                {
                  "namespace": "oci_blockstore",
                  "metrics": {
                    "kind": "all"
                  }
                }
              ]
            }
          }
        ]
      },
      "target": {
        "kind": "objectStorage",
        "bucketName": "<bucket_name>",
        "objectNamePrefix": "<prefix>"
      }
    }

Etapes suivantes

Pour visualiser les objets dans la console, sélectionnez le nom du bucket affiché sur la page de détails du connecteur. (Vous devrez peut-être faire défiler la page vers le bas pour voir le nom du bucket.)

Pour plus d'informations sur le téléchargement d'objets, reportez-vous à Téléchargement d'un objet Object Storage.

Si aucune mesure n'existe dans le bucket, reportez-vous aux informations de dépannage dans Aucune donnée n'est en cours de déplacement. Pour obtenir une aide générale sur le dépannage, reportez-vous à Dépannage des connecteurs.