Creación de una configuración de agente

• Consola
• CLI
• API

• 1. En la página de lista Configuraciones de agente, en Supervisión, seleccione Crear configuración de agente. Si necesita ayuda para buscar la página de lista, consulte Listado de configuraciones de agente.
  2. En el panel Crear configuración de agente, introduzca un nombre y una descripción para la configuración. Evite introducir información confidencial.
  3. Seleccione el compartimento en el que desea crear la configuración.
  4. En Seleccionar grupos de hosts, en Tipo de grupo, seleccione una opción y, a continuación, seleccione el grupo que desee.
     Por ejemplo, seleccione Grupo dinámico y, a continuación, seleccione el grupo dinámico que coincida con los recursos con las configuraciones de agente.
  5. En Configuración de agente, introduzca la URL base de la entrada de métrica.

     Por ejemplo, exponga las métricas de una máquina virtual (VM) mediante un punto final HTTP en formato Prometheus:

     http://1.2.3.4:9100/metrics

  6. Opcionalmente, seleccione Otro punto final para agregar otro punto final.
     Todos los puntos finales van al mismo compartimento y espacio de nombres.
  7. En Seleccionar destino de métrica, seleccione el compartimento y el espacio de nombres de métrica en los que desea publicar métricas personalizadas.
  8. (Opcional) Agregue una o más etiquetas a la configuración del agente: seleccione Mostrar opciones adicionales para mostrar la sección Agregar etiquetas.
     Si tiene permisos para crear un recurso, también los tiene para aplicar etiquetas de formato libre a ese recurso. Para aplicar una etiqueta definida, debe tener permisos para utilizar el espacio de nombres de la etiqueta. Para obtener más información sobre el etiquetado, consulte Etiquetas de recursos. Si no está seguro de si aplicar etiquetas, omita esta opción o pregunte a un administrador. Puede aplicar etiquetas más tarde.
  9. Haga clic en Crear.

  La configuración del agente recién creada se muestra en la página Configuración de agente.

• Utilice el comando oci logging agent-configuration create y los parámetros necesarios para crear una configuración del agente:

  oci logging agent-configuration create compartment-id compartment_ocid --is-enabled [true|false] --service-configuration service_configuration [OPTIONS]

  Comando de ejemplo y archivos 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"
          }
        }
      ]
    }

  Para obtener una lista completa de parámetros y valores para los comandos de la CLI, consulte la Referencia de comandos de CLI.

• Ejecute la operación CreateUnifiedAgentConfiguration para crear una configuración de agente.

  Ejemplo de solicitud de 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>"
  }