Création d'une configuration d'agent

Créez une configuration d'agent dans Logging pour inclure des données de mesure dans une mesure personnalisée.

Les mises à jour de configuration d'agent sont détectées et chargées automatiquement.

    1. Ouvrez le menu de navigation et cliquez sur Observation & gestion. Sous Surveillance, cliquez sur Configurations d'agent.
    2. Sous Portée de la liste, sélectionnez un compartiment dans lequel vous êtes autorisé à travailler.
    3. Cliquez sur Créer une configuration d'agent.
    4. Dans le panneau Créer une configuration d'agent, entrez le nom et la description de la configuration. Evitez de saisir des informations confidentielles.
    5. Sélectionnez le compartiment dans lequel créer la configuration.
    6. Sous Choisir des groupes d'hôtes, pour Type de groupe, sélectionnez une option, puis le groupe de votre choix.
      Par exemple, sélectionnez Groupe dynamique, puis le groupe dynamique qui met en correspondance les ressources avec les configurations d'agent.
    7. Sous Configuration de l'agent, entrez l'URL de base de l'entrée de mesure.

      Par exemple, exposez les mesures d'une machine virtuelle à l'aide d'une adresse HTTP au format Prometheus :

      http://1.2.3.4:9100/metrics
    8. Vous pouvez également cliquer sur Une autre adresse pour en ajouter une autre.
      Toutes les adresses accèdent au même compartiment et au même espace de noms.
    9. Sous Sélectionner une destination de mesure, sélectionnez le compartiment et l'espace de noms de mesure vers lesquels publier des mesures personnalisées.
    10. (Facultatif) Cliquez sur Afficher les options supplémentaires. Sous Ajouter des balises, ajoutez des balises selon vos besoins.
    11. Cliquez sur Créer.
    La configuration d'agent est créée et apparaît sur la page Configurations d'agent.
  • Utilisez la commande oci logging agent-configuration create et les paramètres requis pour créer une configuration d'agent :

    oci logging agent-configuration create compartment-id compartment_ocid --is-enabled [true|false] --service-configuration service_configuration [OPTIONS]
    Exemples de commandes et de fichiers JSON
    oci logging agent-configuration create --description <description> \
    --display-name <display_name> --group-association file://group-association.json \
    --compartment-id <compartment_id> --is-enabled true \
    --service-configuration file://create-service-configuration.json --wait-for-state SUCCEEDED --max-wait-seconds 60

    group-association.json:

    {
      "groupList": [
        "<dynamic_group_id>"
      ]
    }

    create-service-configuration.json:

    {
        "configurationType": "MONITORING",
        "applicationConfigurations": [
          {
            "sourceType": "KUBERNETES",
            "source": {
              "name": "KUBERNETES-uniqueid",
              "scrapeTargets": [
                {
                  "resourceType": "PODS",
                  "k8sNamespace": "k8s-namespace"
                }
              ]
            },
            "destination": {
              "compartmentId": "<compartment_id>",
              "metricsNamespace": "metricsnamespace"
            },
            "filter": {
              "allowList": [
                "regex-test"
              ],
              "denyList": [],
              "filterType": "KUBERNETES_FILTER",
              "name": "test"
            }
          }
        ]
      }

    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.

  • Exécutez l'opération CreateUnifiedAgentConfiguration pour créer une configuration d'agent.

    Exemple de demande d'API
    POST /20200531/unifiedAgentConfigurations
    Host: https://logging.us-phoenix-1.oci.oraclecloud.com
    <authorization and other headers>
    {
      "serviceConfiguration": {
        "configurationType": "MONITORING",
        "applicationConfigurations": [
          {
            "sourceType": "KUBERNETES",
            "source": {
              "name": "KUBERNETES-uniqueid",
              "scrapeTargets": [
                {
                  "resourceType": "PODS",
                  "k8sNamespace": "k8s-namespace"
                }
              ]
            },
            "destination": {
              "compartmentId": "<compartment_id>",
              "metricsNamespace": "metricsnamespace"
            },
            "filter": {
              "allowList": [
                "regex-test"
              ],
              "denyList": [],
              "filterType": "KUBERNETES_FILTER",
              "name": "test"
            }
          }
        ]
      },
      "displayName": "mar-test",
      "isEnabled": true,
      "groupAssociation": {
        "groupList": [
          "<dynamic_group_id>"
        ]
      },
      "description": "test",
      "compartmentId": "<compartment_id>"
    }