Instalación del agente

Obtenga información sobre cómo instalar Unified Monitoring Agent, ya sea para instancias nuevas, instancias existentes o creadas a partir de imágenes personalizadas, o para instancias que no son de Oracle Cloud Infrastructure.

En las nuevas instancias de Oracle Cloud Infrastructure con sistemas operativos soportados, puede activar el agente directamente durante la creación. Para las instancias nuevas y existentes con sistemas operativos soportados, el plugin Supervisión de logs personalizados debe estar activado y todos los plugins deben estar en ejecución. Consulte Plugins disponibles para obtener más información.

Instalación manual

Si ya tiene activado el plugin de supervisión de logs personalizados, se aplicará automáticamente un parche a su instancia para instalar el agente. De lo contrario, puede utilizar las siguientes instrucciones de instalación manual.

Ejecute el siguiente comando para obtener más información sobre las últimas versiones de descarga de agentes para cada sistema operativo:

oci os object get --namespace axmjwnk4dzjv --bucket-name unified-monitoring-agent-config --name versionInfoV2.yml --file versionInfoV2.yml --profile <profile-name> --auth security_token

El comando descarga el archivo versionInfoV2.yml con el siguiente contenido:

versionInfoComposite:
  Oracle Linux Server:
    prefix: "unified-monitoring-agent-ol-"
    stableVersion: "0.1.38"
    postStableVersionComposite:
      default:
  CentOS Linux:
    prefix: "unified-monitoring-agent-cl-"
    stableVersion: "0.1.38"
    postStableVersionComposite:
      default:
  Ubuntu:
    prefix: "unified-monitoring-agent-ub-"
    stableVersion: "0.1.38"
    postStableVersionComposite:
      default:
  Windows:
    prefix: "unified-monitoring-agent-win-"
    stableVersion: "0.1.38"
    postStableVersionComposite:
      default:
  Debian GNU/Linux:
    prefix: "unified-monitoring-agent-deb-"
    stableVersion: "0.1.38"
    postStableVersionComposite:
      default:

El campo stableVersion de versionInfoV2.yml muestra el número de versión más reciente que se utilizará para cada sistema operativo.

Nota

Para los paquetes de Red Hat Linux, utilice la sección Oracle Linux Server para especificar el número de versión.

Después de encontrar el número de versión adecuado, realice los siguientes pasos de configuración, ya sea para Linux o Windows.

Linux:

Conéctese a la instancia.
Configure la autenticación basada en tokens para la CLI.

Utilice el siguiente comando para descargar el agente non-FIPS o FIPS-enabled para el sistema operativo Linux y, al mismo tiempo, sustituya <bucket>, <name> y <file> para la versión concreta del sistema operativo:

oci os object get --namespace axmjwnk4dzjv --bucket-name <bucket> --name <name> --file <file> --profile OC1 --auth security_token


versión del sistema operativo	`<Cubo>`	`<Name>` y `<File>`
agente que no es FIPS: x86
Oracle Linux 7	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-7-<version>.rpm`
Oracle Linux 8	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-8-<version>.rpm`
Oracle Linux 9	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-9-<version>.rpm`
CentOS 7	`unified-monitoring-agent-cl-bucket`	`unified-monitoring-agent-cl-7-<version>.rpm`
Red Hat Enterprise Linux 8	`unified-monitoring-agent-rl-bucket`	`unified-monitoring-agent-rhel-8-<version>.rpm`
Red Hat Enterprise Linux 9	`unified-monitoring-agent-rl-bucket`	`unified-monitoring-agent-rhel-9-<version>.rpm`
Ubuntu 16.04	`unified-monitoring-agent-ub-bucket`	`unified-monitoring-agent-ub-16-<version>.deb`
Ubuntu 18.04	`unified-monitoring-agent-ub-bucket`	`unified-monitoring-agent-ub-18-<version>.deb`
Ubuntu 20.04	`unified-monitoring-agent-ub-bucket`	`unified-monitoring-agent-ub-20-<version>.deb`
Ubuntu 22.04	`unified-monitoring-agent-ub-bucket`	`unified-monitoring-agent-ub-22-<version>.deb`
agente que no es FIPS: ARM
Oracle Linux 7	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-7-<version>.aarch64.rpm`
Oracle Linux 8	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-8-<version>.aarch64.rpm`
Oracle Linux 9	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-9-<version>.aarch64.rpm`
Red Hat Enterprise Linux 8	`unified-monitoring-agent-rl-bucket`	`unified-monitoring-agent-rhel-8-<version>.aarch64.rpm`
Red Hat Enterprise Linux 9	`unified-monitoring-agent-rl-bucket`	`unified-monitoring-agent-rhel-9-<version>.aarch64.rpm`
Agente con FIPS: x86
Oracle Linux 7	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-7-fips-<version>.rpm`
Oracle Linux 8	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-8-fips-<version>.rpm`
Red Hat Enterprise Linux 8	`unified-monitoring-agent-rl-bucket`	`unified-monitoring-agent-rhel-8-fips-<version>.rpm`
Agente con FIPS: ARM
Oracle Linux 7	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-7-fips-<version>.aarch64.rpm`
Oracle Linux 8	`unified-monitoring-agent-ol-bucket`	`unified-monitoring-agent-ol-8-fips-<version>.aarch64.rpm`
Red Hat Enterprise Linux 8	`unified-monitoring-agent-rl-bucket`	`unified-monitoring-agent-rhel-8-fips-<version>.aarch64.rpm`

Ejecute el siguiente comando para instalar el RPM:
```
yum install -y <rpm-name>
```
Para Ubuntu:
```
dpkg -i <deb-package-name>
```

Ventanas:

Conéctese a la instancia.
Configure la autenticación basada en tokens para la CLI.

Utilice el siguiente comando para descargar el agente no activado para FIPS o FIPS para Windows Server 2012, 2016, 2019 y 2022, mientras sustituye <name> y <file> para la versión específica del sistema operativo Windows:

oci os object get --namespace axmjwnk4dzjv --bucket-name unified-monitoring-agent-win-bucket --name <name> --file <file> --profile OC1 --auth security_token


versión del sistema operativo	`<Name>` y `<File>`
agente no FIPS
Windows 2012	`unified-monitoring-agent-win-2012-<version>.msi`
Windows 2016	`unified-monitoring-agent-win-2016-<version>.msi`
Windows 2019	`unified-monitoring-agent-win-2019-<version>.msi`
Windows: 2022	`unified-monitoring-agent-win-2022-<version>.msi`
Agente con FIPS activado
Windows 2012	`unified-monitoring-agent-win-2012-fips-<version>.msi`
Windows 2016	`unified-monitoring-agent-win-2016-fips-<version>.msi`
Windows 2019	`unified-monitoring-agent-win-2019-fips-<version>.msi`
Windows 2022	`unified-monitoring-agent-win-2022-fips-<version>.msi`

Abra un símbolo del sistema elevado (como administrador) y ejecute el comando MSI. La instalación puede tardar hasta cinco minutos en completarse:
```
C:\path\to\file\<unified monitoring agent msi>
```
Para obtener una versión más avanzada del comando anterior para depurar incidencias de instalación de MSI, ejecute:
```
msiexec /i "C:\path\to\file\<unified monitoring agent msi>" /l*v "C:\unified-monitoring-agent_msi.log"
```

Instancias creadas a partir de imágenes personalizadas e instancias que no son de Oracle Cloud Infrastructure

Instale el agente según los mismos pasos de Manual Installation.
Configure las claves de API de usuario para la instancia en la que está ejecutando. Para generar la clave de API de usuario, siga las instrucciones descritas en Cómo generar una clave de firma de API.
- (Linux). Coloque el directorio ".oci" y su contenido en /etc/unified-monitoring-agent.
- (Ventanas). Para Windows, algunos pasos son diferentes, por lo que debe asegurarse de seguir los pasos adecuados. Cree la carpeta ".oci" y su contenido en el directorio C:\oracle_unified_agent.
Siga las instrucciones descritas en Creación de un perfil en el archivo de configuración de la CLI de Oracle Cloud Infrastructure para crear el archivo de configuración con las modificaciones descritas en el siguiente paso.
Después de seguir los pasos de Creación de un perfil en el archivo de configuración de la CLI de Oracle Cloud Infrastructure, asegúrese de asignar al perfil (<profile-name>) de esta sección el nombre "UNIFIED_MONITORING_AGENT".
A continuación se muestra un ejemplo de configuración para que Unified Monitoring Agent la utilice para la autenticación con el servicio:
```
[UNIFIED_MONITORING_AGENT]
user=ocid1.user.region..aaa...
fingerprint=<cert fingerprint>
key_file=/path/to/ocifolder/.oci/private.pem
tenancy=ocid1.tenancy.region..aaa...
region=<instances region>
pass_phrase="pashphrase1234"
```

Recursos del sistema gestionados (no instancias)

Instale el agente de acuerdo con los mismos pasos que en Manual Installation.
Cree un grupo dinámico con una regla coincidente que tenga como destino los recursos de la base de datos y aplíquelo a la configuración de agente. Para obtener más información, consulte Acerca de los grupos dinámicos. Seleccione un grupo dinámico de la lista Grupo que coincida con la regla para un recurso de cualquier tipo de recurso (database, dbsystem, cloudvmcluster).
```
ALL {resource.type = <resource-type>, resource.id = <resource-ocid>}
```
Por ejemplo: ALL {resource.type = 'database', resource.id = 'ocid1.database.oc1.phx.<unique_ID>'}.
Si no está familiarizado con las políticas, consulte Introducción a las políticas y Políticas comunes. Para obtener más información sobre la escritura de políticas para grupos dinámicos u otros componentes de IAM, consulte Detalles de IAM sin dominios de identidad.
Cree una política que otorgue al grupo dinámico que ha creado acceso al servicio Logging.
```
Allow dynamic-group <dynamic-group> to use log-content in compartment <compartment-name>
```
Por ejemplo: Allow dynamic-group linuxdbvm to use log-content in compartment <compartment-name>.

Cree un archivo en el directorio /etc/resource_principal_env del host con el siguiente formato.

OCI_RESOURCE_PRINCIPAL_VERSION=1.1
OCI_RESOURCE_PRINCIPAL_RPT_ENDPOINT=https://database.<oci_region>.oraclecloud.com //The endpoint for retrieving the resource principal token
OCI_RESOURCE_PRINCIPAL_PRIVATE_PEM=/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem //PKI-provisioned certificate
OCI_RESOURCE_PRINCIPAL_REGION=<oci_region> // OCI region
OCI_RESOURCE_PRINCIPAL_RPST_ENDPOINT=https://auth.<oci_region>.oraclecloud.com //The endpoint for retrieving the resource principal session token

A continuación se muestra un ejemplo del servicio Oracle Exadata Database en la región us-phoenix-1:

OCI_RESOURCE_PRINCIPAL_VERSION=1.1
OCI_RESOURCE_PRINCIPAL_RPT_ENDPOINT=https://database.us-phoenix-1.oraclecloud.com
OCI_RESOURCE_PRINCIPAL_PRIVATE_PEM=/etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem
OCI_RESOURCE_PRINCIPAL_REGION=us-phoenix-1
OCI_RESOURCE_PRINCIPAL_RPST_ENDPOINT=https://auth.us-phoenix-1.oraclecloud.com

Para obtener más información, consulte Regiones y dominios de disponibilidad.

Reinicie el agente con el siguiente comando:

sudo systemctl restart unified-monitoring-agent

Documentación de Oracle Cloud Infrastructure

Instalación del agente

Instalación manual

Instancias creadas a partir de imágenes personalizadas e instancias que no son de Oracle Cloud Infrastructure

Recursos del sistema gestionados (no instancias)