1. Configuración de Oracle Cloud Observability and Management en Apache Tomcat en LINUX ARM mediante APM y Stack Monitoring
  2. Configurar y desplegar activos de supervisión

Configurar y desplegar activos de supervisión

Para incorporar los hosts de ARM de Linux con Oracle Database 19c y Apache Tomcat, debe realizar las siguientes tareas:
  1. Despliegue un agente Java de APM en Apache Tomcat.
  2. Configure la supervisión sintética para supervisar los puntos finales de las aplicaciones.
  3. Despliegue los agentes de gestión.
  4. Descubra la infraestructura en Stack Monitoring.

Configuración de Application Performance Monitoring

En primer lugar, configure la supervisión del rendimiento de la aplicación.

Desde el explorador web, conéctese a su arrendamiento de OCI. Introducirá la mayoría de los siguientes comandos desde el shell en la nube. Si no está familiarizado con él, consulte la documentación relacionada. Si no tiene un compartimento para recursos de O&M (como dominios de APM), créelo ahora:
  1. Seleccione Identidad y seguridad, la página Compartimentos y haga clic en Crear compartimento.
  2. Proporcione un nombre y una descripción significativos, por ejemplo:
    • Nombre = om-demo
    • Descripción = Compartment for Observability & Management resources
    Espere un minuto a que se aprovisione el compartimento. Una vez que haya terminado, anote el OCID del compartimento.

Ahora, haga lo siguiente:

  1. Cree un nuevo dominio de nivel gratuito de APM abriendo el shell en la nube y haciendo lo siguiente:
    1. Seleccione un compartimento para los recursos de O&M introduciendo: 
      export COMPARTMENT_OCID=YOUR_COMPARTMENT_OCID
    2. Seleccione el nombre de dominio de APM introduciendo: 
      export APM_DISPLAY_NAME=demoapm01 

oci apm-control-plane apm-domain create --compartment-id $COMPARTMENT_OCID --display-name $APM_DISPLAY_NAME --is-free-tier TRUE --wait-for-state SUCCEEDED --wait-interval-seconds 15
  2. Seleccione Observación y gestión, Application Performance Monitoring y, a continuación, Administración para mostrar el estado de creación (asegúrese de seleccionar el compartimento correcto).
    Espere a que se cree el dominio, que tarda unos cinco minutos. También puede utilizar el shell en la nube para ver el progreso mediante los siguientes comandos: 
    export COMPARTMENT_OCID=YOUR_COMPARTMENT_OCID 

oci apm-control-plane apm-domain list --compartment-id $COMPARTMENT_OCID --all --query "data[].{\"display-name\":\"display-name\",\"lifecycle-state\":\"lifecycle-state\",\"id\":\"id\"}" --output table
    Verá una respuesta como la siguiente:
    +--------------+-----------------------------+-----------------+
| display-name | id                          | lifecycle-state |
+--------------+-----------------------------+-----------------+
| demoapm01    | ocid1.apmdomain.oc1.***.*** | ACTIVE          |
+--------------+-----------------------------+-----------------+
  3. Nota del OCID de dominio de APM e introduzca los siguientes comandos para generar data-upload-endpoint y datakeys (que utilizará más adelante para instalar el agente de APM de Java):
    export APM_OCID=YOUR_APM_DOMAIN_OCID

oci apm-control-plane apm-domain get --apm-domain-id $APM_OCID --query "data.{\"data-upload-endpoint\":\"data-upload-endpoint\"}" --output table

oci apm-control-plane data-key list --apm-domain-id $APM_OCID --all --query "data[].{\"name\":\"name\",\"type\":\"type\",\"value\":\"value\"}" --output table
    Verá una respuesta como la siguiente:
    +-----------------------------------------------------------------------------+
| data-upload-endpoint                                                        |
+-----------------------------------------------------------------------------+
| https://***.apm-agt.***.oci.oraclecloud.com                                 |
+-----------------------------------------------------------------------------+ 

+--------------------------------+---------+----------------------------------+
| name                           | type    | value                            |
+--------------------------------+---------+----------------------------------+
| auto_generated_private_datakey | PRIVATE | ******************************** |
| auto_generated_public_datakey  | PUBLIC  | ******************************** |
+--------------------------------+---------+----------------------------------+
  4. Seleccione Observación y gestión, Application Performance Monitoring y, a continuación, Administración, descargue el agente Java de la página Descargar agentes de APM.
  5. Copie el archivo JAR en cada host de Apache Tomcat:
    [tomcat@stvociapp021 ~]$ pwd
/home/tomcat
[tomcat@stvociapp021 ~]$ ls -l apm-java-agent-installer-1.10.1.3.jar
-rwxrwxr-x. 1 tomcat tomcat 11741769 Jul 26 07:39 apm-java-agent-installer-1.10.1.3.jar
[tomcat@stvociapp021 ~]$
  6. Instale Java Agent con el usuario Tomcat mediante los siguientes comandos (configure VARIABLES según su propio entorno):
    1. Defina la ruta de acceso del directorio raíz de instalación de Apache Tomcat: 
      export APM_INSTALL_DESTINATION=/opt/tomcat
    2. Defina la ruta de acceso completa de JAR de instalación de APM: 
      export APM_INSTALLER=/home/tomcat/apm-java-agent-installer-1.10.1.3.jar
    3. Seleccione el nombre de servicio que se utilizará en la exportación del dominio de APM: 
      APM_SERVICE_NAME=apex_tomcat_service
    4. Agregar información de dominio de APM:
      export APM_PRIVATE_KEY=YOUR_PRIVATE_KEY 
export APM_ENDPOINT=YOUR_APM_ENDPOINT 
export APM_PUBLIC_KEY=YOUR_PUBLIC_KEY
    5. Si es necesario, agregue opciones de APM adicionales; por ejemplo, instantáneas de thread o Activar inyección de agente de explorador de APM: 
      export APM_ADDITIONAL_OPTIONS="-property=com.oracle.apm.agent.deepdive.trace.snapshots.collection.enable=true"
    6. Defina las variables JAVA_HOME y PATH: 
      export JAVA_HOME=PATH_TO_JAVA_HOME 
export PATH=$JAVA_HOME/bin:$PATH
    7. Instale el agente Java de APM: 
      java -jar ${APM_INSTALLER} provision-agent -service-name=${APM_SERVICE_NAME} -destination=${APM_INSTALL_DESTINATION} -private-data-key=${APM_PRIVATE_KEY} -data-upload-endpoint=${APM_ENDPOINT} ${APM_ADDITIONAL_OPTIONS} -public-data-key=${APM_PUBLIC_KEY}
  7. Modifique Apache Tomcat JAVA_OPTS agregando la propiedad javaagent; por ejemplo:
    export JAVA_OPTS="-Dconfig.url=${ORDS_CONFIG} -Xms1024M -Xmx4096M -Djava.net.preferIPv4Stack=true -Djava.net.preferIPv4Addresses=true -javaagent:${TOMCAT_HOME}/oracle-apm-agent/bootstrap/ApmAgent.jar "
  8. Reinicie Apache Tomcat.
  9. Verifique el archivo log del agente de Java (cambie TOMCAT_HOME a la ruta de acceso del directorio raíz de instalación de Tomcat): 
    ls -l ${TOMCAT_HOME}/oracle-apm-agent/log/*/Agent*
  10. Por último, seleccione Observación y gestión, Application Performance Monitoring y, a continuación, Explorador de rastreo y verifique que los rastreos se recopilan correctamente.

Configurar supervisión sintética

Después de configurar el agente Java de APM en Apache Tomcat, puede crear supervisiones para simular la actividad del usuario en la aplicación. Utilice la consola de OCI o OCI Cloud Shell para crear mediante programación los recursos de OCI.

Navegue a la página Supervisión sintética (Observación y gestión, Application Performance Monitoring y, a continuación, Supervisión sintética) para crear las supervisiones que probarán continuamente los puntos finales de la aplicación.

Abra el shell en la nube para crear rápidamente un monitor BROWSER para la aplicación. A continuación, haga lo siguiente:

  1. Obtenga la lista de puntos de observación disponibles: 
    export APM_OCID=YOUR_APM_DOMAIN_OCID 

oci apm-synthetics public-vantage-point-collection list-public-vantage-points --apm-domain-id $APM_OCID
  2. Pruebe los puntos finales de la aplicación (en este ejemplo se utiliza la región Ashburn para probar estos puntos finales):
    echo "[\"OraclePublic-us-ashburn-1\"]" > $HOME/vantage_points.json
  3. Cree el archivo JSON para la configuración de disponibilidad:
    echo {\"maxAllowedFailuresPerInterval\": 0, \"minAllowedRunsPerInterval\": 1} >  availability_configuration.json
  4. Cree el archivo JSON para las medidas de red:
    echo {\"probeMode\": \"SACK\",  \"probePerHop\": 3,  \"protocol\": \"TCP\" } > network_measurements.json
  5. Por último, cree la supervisión:
    1. Identifique el dominio de APM:
      export APM_OCID=YOUR_APM_DOMAIN_OCID
    2. Proporcione el nombre del monitor: 
      export MONITOR_DISPLAY_NAME=demo-monitor-01
    3. Proporcione la URL de punto final de aplicación: 
      export MONITOR_TARGET=http://LOAD_BALANCER_PUBLIC_IP/APPLICATION_TEST_URL
    4. Proporcione el intervalo de supervisión, en segundos:
       export MONITOR_REPEAT_INTERVAL=360 oci apm-synthetics monitor create-browser-monitor --apm-domain-id $APM_OCID --display-name $MONITOR_DISPLAY_NAME --monitor-type BROWSER --repeat-interval-in-seconds $MONITOR_REPEAT_INTERVAL --vantage-points file://$HOME/vantage_points.json --is-certificate-validation-enabled FALSE --is-failure-retried true --target $MONITOR_TARGET --availability-configuration file://$HOME/availability_configuration.json --network-configuration file://$HOME/network_measurements.json
En la página Supervisión sintética, puede ver el estado de la supervisión que acaba de crear. En este ejemplo, la URL proporcionada se supervisa cada seis minutos (para ver los detalles de los resultados de la prueba, haga clic en el nombre de la supervisión y seleccione Historial en el menú Recursos).

Despliegue del Agente de Gestión

Antes de configurar la supervisión de pila, debe instalar Oracle Management Agent en cada host que desee supervisar. Esta demostración utiliza la instalación de RPM para Management Agent (puede utilizar este método si el host de Linux ARM se está ejecutando localmente o en un proveedor en la nube diferente).

Nota:

Si no sabe cómo instalar Oracle Management Agent, consulte "Instalar agentes de gestión" en la documentación de OCI, a la que se puede acceder desde el tema "Explorar más" al final de este manual.
Antes de empezar, descargue el software Management Agent desde la página Downloads and Keys (Descargas y claves):
  1. Seleccione Management Agent y, a continuación, Downloads and Keys (Descargas y claves).
  2. Seleccione Agente para LINUX (AARCH64) con el tipo de paquete RPM.
  3. En la misma página, cree una nueva clave de instalación para configurar el agente. Proporcione los parámetros necesarios:
    • Nombre de clave = demo-key-01
    • Compartimento = om-demo
    • Máximo de instalaciones = default

Nota:

Si no sabe cómo crear una clave de instalación, consulte "Crear clave de instalación" en la documentación de OCI, a la que se puede acceder desde el tema "Explorar más" al final de este manual.
Ahora, despliegue el agente de gestión:
  1. Conéctese a las instancias de Linux mediante SSH y, si aún no lo ha hecho, instale JDK8: 
    # dnf install -y java-1.8.0-openjdk
  2. Instalación de Management Agent: 
    # rpm -ivh oracle.mgmt_agent.230622.2155.Linux-Aarch64.rpm
  3. Configure Management Agent, como se muestra en el siguiente ejemplo:
    1. Abra un editor vi:
      # vi /usr/share/mgmt_agent/input.rsp
    2. Agregue el siguiente contenido: 
      ManagementAgentInstallKey = <COPY_YOUR_KEY_HERE>
CredentialWalletPassword = <CHOOSE_YOUR_WALLET_PASSWORD>
    3. Cambie el propietario del agente de gestión:
      # chown mgmt_agent. /usr/share/mgmt_agent/input.rsp
  4. Ejecute el siguiente comando para finalizar la configuración del agente de gestión:
    # sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=/usr/share/mgmt_agent/input.rsp
Tras unos minutos, verá el agente en "Management Agent" y, a continuación, en la página "Agents". No es necesario activar el plugin Supervisión de pila; Supervisión de pila lo activa automáticamente.

Activar supervisión completa del host

Con el servicio de supervisión de pila activado, debe activar la supervisión completa de los hosts en los que se basa la aplicación. Stack Monitoring preparará automáticamente una tarea para permitir la supervisión de una instancia informática de OCI. Para activar la supervisión completa, seleccione Ascender a supervisión completa. Identifique los hosts Tomcat y Oracle Database de la lista de hosts disponibles para ascender y seleccionar Ascender. Esto invocará una deslizamiento hacia afuera; desde esta diapositiva, verifique que el nombre del recurso coincida con el nombre del dominio completo del host. A continuación, haga clic en Promocionar. En cuestión de minutos, el servicio de control de pila creará una nueva página inicial y comenzará a recopilar las nuevas métricas.

Configurar supervisión de pila

Por último, debe configurar la supervisión de pila.

Antes de configurar realmente el servicio, debe cumplir estos requisitos:
  1. Active el servicio de supervisión de pila.
  2. Active la supervisión de JMX.
  3. Cree el usuario de supervisión de Oracle Database.
A continuación, realice estos pasos para configurar la supervisión de pila:
  1. Active la supervisión completa de los hosts.
  2. Detectar Oracle Database.
  3. Descubra Apache Tomcat.
Estos procesos se describen en los siguientes pasos.
  1. Active el servicio de supervisión de pila:
    Vaya a Observación y gestión, Application Performance Monitoring y, a continuación, a Supervisión de pila y haga clic en Activar supervisión de pila.
  2. Active JMX en Apache Tomcat:
    La supervisión de pila requiere que JMX esté activado antes de la detección. Para activar JMX en Apache Tomcat, realice lo siguiente:
    1. Agregue las siguientes líneas a setenv.bat: 
      set CATALINA_OPTS=-Dcom.sun.management.jmxremote 
-Dcom.sun.management.jmxremote.port=9012 
-Dcom.sun.management.jmxremote.ssl=false 
-Dcom.sun.management.jmxremote.authenticate=false
    2. Cree la carpeta de configuración para almacenar los archivos jmxremote.access y jmxremote.password: 
      mkdir -p /opt/tomcat/conf
    3. Cree jmxremote.access como usuario tomcat: 
      cd /opt/tomcat/conf 
echo "monitorRole readonly 
controlRole readwrite" > jmxremote.access
    4. Agregue lo siguiente al archivo jmxremote.password. Tenga en cuenta que el archivo de contraseñas debe ser de solo lectura y solo el usuario del sistema operativo Tomcat se está ejecutando. Como usuario Tomcat: 
      cd /opt/tomcat/conf 
echo "monitorRole tomcat 
controlRole tomcat" > jmxremote.password
    5. Reinicie Apache Tomcat.
  3. Cree el usuario de supervisión de la base de datos:
    Antes de detectar una base de datos en Stack Monitoring, asegúrese de que tiene acceso al usuario de supervisión. Puede utilizar el usuario de DBSNMP que está integrado con Oracle Database y tiene los privilegios necesarios para supervisar la base de datos O crear un usuario personalizado con solo los privilegios necesarios. Los pasos para crear un usuario de supervisión de base de datos se pueden encontrar en MOS Nota: 2857604.1, a la que puede acceder desde "Explore More" al final de este manual.
  4. Active la supervisión completa del host:
    Con el servicio de supervisión de pila activado, el primer paso es activar la supervisión completa de los hosts en los que se basa la aplicación. Stack Monitoring preparará automáticamente una tarea para permitir la supervisión de una instancia informática de OCI. Para activar la supervisión completa:
    1. Haga clic en Ascender a supervisión completa.
    2. Identifique los hosts Tomcat y Oracle Database de la lista de hosts disponibles para promocionar y haga clic en Ascender. Esto llamará a una presentación.
    3. En esta diapositiva, verifique que Resource Name coincida con el nombre del dominio completo de los hosts y, a continuación, haga clic en Promote.

    En cuestión de minutos, el servicio de control de pila creará una nueva página inicial y comenzará a recopilar las nuevas métricas.

  5. Descubra la base de datos Oracle en la que se basa la aplicación:
    Descubra los recursos fácilmente con la sencilla interfaz de usuario de detección en blanco de Stack Monitoring. Para empezar:
    1. Navegue a la página "Detección de recursos" y haga clic en Detectar nuevo recurso. Una vez seleccionada, aparecerá una ventana desplegable.
    2. En el menú desplegable, seleccione Oracle Database.
    3. Complete los campos, como Resource Name (Nombre de recurso), DNS hostname (Nombre de host DNS), Service Name (Nombre de servicio) y haga clic en Discover New Resource (Detectar nuevo recurso).

    Cuando el trabajo complete Stack Monitoring comenzará inmediatamente a recopilar métricas y crear una página inicial.

  6. Detección de los servidores Apache Tomcat
    Para descubrir Apache Tomcat:
    1. Vaya a "Detección de recursos" y haga clic en Detectar nuevo recurso.
    2. En la lista desplegable, seleccione Apache Tomcat.
    3. Complete los campos completos en blanco, como el puerto JMX, supervise el nombre de usuario y la contraseña y haga clic en Descubrir nuevo recurso.

    Una vez finalizado el trabajo, vaya a "Enterprise Summary" de Stack Monitoring. El panel de control mostrará el rendimiento y el estado de Oracle Database, Apache Tomcat y los hosts en los que se basa Tomcat.

    A continuación, relacione los recursos, lo que permitirá una fácil navegación hacia arriba y hacia abajo en la pila de aplicaciones. Para obtener más información sobre la relación de los recursos, consulte "Actualización de la topología de aplicaciones" (a la que puede acceder desde el tema "Explorar más" al final de este manual).

    Por último, configure alarmas para los recursos. Ejemplos de alarmas:
    • Host
      • Utilización del sistema de archivos
      • Uso de Memoria y CPU
      • Estado de Control
    • Oracle Database
      • Estado de Control
      • CPU y Memoria
      • Tiempo de espera
      • Utilización de almacenamiento por tablespace
    • Apache Tomcat
      • Estado de Control
      • Uso de memoria de JVM (pila y no pila)
      • Uso de CPU