Oracle Cloud Infrastructure - Dokumentation

Agent-Konfiguration erstellen

Erstellen Sie eine Agent-Konfiguration in Logging, um Metrikdaten in eine benutzerdefinierte Metrik aufzunehmen.

Aktualisierungen der Agent-Konfiguration werden erkannt und automatisch geladen.

    1. Wählen Sie auf der Listenseite Agent-Konfigurationen unter Monitoring die Option Agent-Konfiguration erstellen aus. Wenn Sie Hilfe beim Suchen der Listenseite benötigen, finden Sie weitere Informationen unter Agent-Konfigurationen auflisten.
    2. Geben Sie im Bereich Agent-Konfiguration erstellen einen Namen und eine Beschreibung für die Konfiguration ein. Geben Sie dabei keine vertraulichen Informationen ein.
    3. Wählen Sie das Compartment, in welchem Sie die Konfiguration erstellen möchten.
    4. Wählen Sie unter Hostgruppen auswählen unter Gruppentyp eine Option aus, und wählen Sie dann die gewünschte Gruppe aus.
      Beispiel: Wählen Sie Dynamische Gruppe aus, und wählen Sie dann die dynamische Gruppe aus, die den Ressourcen mit den Agent-Konfigurationen entspricht.
    5. Geben Sie unter Agent-Konfiguration die Basis-URL für die Metrikeingabe ein.

      Beispiel: Sie können Metriken von einer virtuellen Maschine (VM) mit einem HTTP-Endpunkt im Prometheus-Format bereitstellen:

      http://1.2.3.4:9100/metrics
    6. Wählen Sie optional Weiterer Endpunkt aus, um einen weiteren Endpunkt hinzuzufügen.
      Alle Endpunkte gehen zu demselben Compartment und Namespace.
    7. Wählen Sie unter Metrikziel auswählen das Compartment und den Metrik-Namespace aus, in dem Sie benutzerdefinierte Metriken veröffentlichen möchten.
    8. (Optional) Fügen Sie ein oder mehrere Tags zur Agent-Konfiguration hinzu: Wählen Sie Weitere Optionen anzeigen aus, um den Abschnitt Tags hinzufügen anzuzeigen.
      Wenn Sie über Berechtigungen zum Erstellen von Ressourcen verfügt, sind Sie auch berechtigt: Freiformtags auf diese Ressource anwenden. Um ein definiertes Tag anzuwenden, benötigen Sie Die Berechtigungen zum Verwenden des Tag-Namespace. Weitere Informationen zum Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Tags angewendet werden sollen, überspringen Sie diese Option, oder fragen Sie einen Administrator. Sie können Tags später anwenden.
    9. Wählen Sie Erstellen aus.
    Die neu erstellte Agent-Konfiguration wird auf der Seite Agent-Konfigurationen aufgeführt.

  • Verwenden Sie den Befehl oci logging agent-configuration create und die erforderlichen Parameter, um eine Agent-Konfiguration zu erstellen:

    oci logging agent-configuration create compartment-id compartment_ocid --is-enabled [true|false] --service-configuration service_configuration [OPTIONS]
    Beispielbefehl und JSON-Dateien
    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"
        }
      }
    ]
  }

    Eine vollständige Liste der Parameter und Werte für CLI-Befehle finden Sie in der CLI-Befehlsreferenz.

  • Führen Sie den Vorgang CreateUnifiedAgentConfiguration aus, um eine Agent-Konfiguration zu erstellen.

    Beispiel-API-Anforderung
    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>"
}