Voraussetzungen für Hostname

Stellen Sie sicher, dass der Befehl hostname -d den Domainnamen zurückgibt, oder dass der Befehl hostname -a den richtigen Kurznamen als ersten Alias zurückgibt. Der Kurzname wird in der Spalte HOST_NAME der Tabelle v$instances der Datenbank angezeigt, die erkannt werden soll. Dazu aktualisieren Sie die Datei /etc/hosts so, dass der richtige Alias wie oben als erster Alias zurückgegeben wird.

Agent-Anforderungen

• Jeder Knoten des Oracle Database-Clusters muss über einen lokal installierten Management Agent verfügen.

• Stellen Sie sicher, dass der Benutzer mgmt_agent oder oracle-cloud-agent basierend auf dem installierten Agent-Typ in der Oracle Inventory-Gruppe (in der Regel oinstall) aus /etc/oraInst.loc enthalten ist, um die Befehle lsnrctl, srvctl und crsctl ausführen zu können.

  Verwenden Sie die folgende Anweisung, um dem Benutzer mgmt_agent oder oracle-cloud-agent je nach installiertem Agent oinstall-Berechtigungen zu erteilen:

  • Host mit Oracle Cloud Agent:

    usermod -aG oinstall oracle-cloud-agent

  • Host mit Standalone Agent:

    usermod -aG oinstall mgmt_agent

• Die Gruppe muss über Ausführungsberechtigungen für das Oracle-Installationsverzeichnis verfügen.

  Beispiel für das Hinzufügen von Gruppenausführungsberechtigungen zum Verzeichnis:

  chmod g+x /u01/app/oracle

Nachdem Sie die BS-Berechtigungen erteilt haben, starten Sie den Agent mit den folgenden Anweisungen neu. Verwenden Sie die entsprechenden Anweisungen für den Agent bzw. das Betriebssystem:

• Oracle Cloud Agent:

  sudo systemctl stop oracle-cloud-agent

  Starten Sie dann den Agent mit dem Startbefehl.

• Standalone Agent:

  sudo systemctl stop mgmt_agent

  Starten Sie dann den Agent mit dem Startbefehl.

Voraussetzung für Monitoringzugangsdaten

Bevor Sie eine Datenbank in Stack Monitoring ermitteln, stellen Sie sicher, dass Sie Zugriff auf den Monitoringbenutzer haben. Sie können entweder einen in Oracle Database integrierten DBSNMP-Benutzer verwenden, der über die erforderlichen Berechtigungen zum Überwachen der Datenbank verfügt, oder einen benutzerdefinierten Benutzer mit nur den erforderlichen Berechtigungen erstellen. Schritte zum Erstellen eines Datenbanküberwachungsbenutzers finden Sie unter CMOS-Hinweis KB57458.

Für ASM:

• Sie müssen ein ASMSNMP-Benutzerprofil oder die zugehörigen Berechtigungen verwenden.
• Der Benutzer muss über ein Secret-Kennwort für ASM verfügen. Informationen zu den ersten Schritten beim Erstellen eines Secrets finden Sie unter Secrets verwalten.

Voraussetzung für TCPS-fähige Oracle Database

Stack Monitoring unterstützt TCP- und TCPS-Konnektivitätsprotokolle für Oracle-Datenbanken. Mit dem TCPS-Protokoll kann eine Oracle-Anwendung auf einem Client über TCP/IP und SSL mit Remotedatenbanken kommunizieren, was eine höhere Sicherheit als TCP allein bietet. Dieser neue Listener kann verwendet werden, um über einen sicheren Kanal mit der Datenbank zu kommunizieren. Um eine Datenbank mit TCPS zu erkennen, müssen Sie der Oracle-Datenbank einen TCPS-Listener hinzufügen und auf den Wallet-Speicherort zugreifen, wie in den folgenden vier Schritten dargestellt.

Schritt 1: Oracle Database und Listener zur Unterstützung von TCPS konfigurieren, siehe Transport Layer Security-Authentifizierung konfigurieren.

Schritt 2: Keystore/TrustStore in Management Agent importieren und seine Berechtigungen aktualisieren.

1. Identifizieren und exportieren Sie das Oracle Database-Wallet-Verzeichnis entsprechend dem verwendeten KeyStore-Typ (PKCS oder JKS).

   PKCS

   export WALLET_LOCATION=<database_wallet_location>/dbwallets

   JKS

   export WALLET_LOCATION=<database_wallet_location>/jkswallets

2. Kopieren Sie das Wallet in ein sicheres, lesbares Verzeichnis auf dem Agent-Host.

   cp -r $WALLET_LOCATION <secure_readable_dir>/

3. Aktualisieren Sie die Wallet-Berechtigung.

   Auf OCI Compute

   PKCS

   sudo chown -R oracle-cloud-agent:oracle-cloud-agent <secure_readable_dir>/dbwallets

   JKS

   sudo chown -R oracle-cloud-agent:oracle-cloud-agent <secure_readable_dir>/jkswallets

   On-Premise-Compute:

   PKCS

   sudo chown -R mgmt_agent:mgmt_agent <secure_readable_dir>/dbwallets

   JKS

   sudo chown -R mgmt_agent:mgmt_agent <secure_readable_dir>/jkswallets

Schritt 3: OCI Secret erstellen.

Informationen zu den ersten Schritten beim Erstellen eines Secrets finden Sie unter Secrets verwalten.

Secret-Beispiele:

PKCS

{
    "sslTrustStoreType": "PKCS12",
    "sslTrustStoreLocation": "/<secure_readable_dir>/dbwallets/cwallets/ewallet.p12",
    "sslTrustStorePassword": "<truststore_password>",
    "sslKeyStoreType": "PKCS12",
    "sslKeyStoreLocation": "/<secure_readable_dir>/dbwallets/swallets/ewallet.p12",
    "sslKeyStorePassword": "<truststore_password>",
    "sslServerCertDn": "C=US,O=MyCorp,CN=sslclient"
}

JKS

{
    "sslTrustStoreType": "JKS",
    "sslTrustStoreLocation": "/<secure_readable_dir>/jkswallets/truststore.jks",
    "sslTrustStorePassword": "<truststore_password>",
    "sslKeyStoreType": "JKS",
    "sslKeyStoreLocation": "/<secure_readable_dir>/jkswallets/keystore.jks",
    "sslKeyStorePassword": "<truststore_password>",
    "sslServerCertDn": "C=US,O=MyCorp,CN=sslclient"
}

Schritt 4: Policys validieren

Neben der Erstellung eines Secrets muss der Admin-Gruppe "Stackmonitoring" die Berechtigung zum Lesen des Vaults erteilt werden, in dem das Secret gespeichert ist. Weitere Informationen zum Erteilen von Leseberechtigungen für eine Secret-Familie in einem angegebenen Compartment finden Sie unter Erforderliche Policys erstellen.

Wenn Oracle Database ältere Kennwortversionen verwendet

Führen Sie für Datenbanken, die für die Verwendung der Kennwortversion kleiner als 12 (SQLNET.ALLOWED_LOGON_VERSION < 12) konfiguriert sind, wie bestimmte E-Business Suite-Datenbanken, die folgenden zusätzlichen Schritte aus, um den Management Agent für die Kommunikation mit der Datenbank mit älteren Kennwortversionen zu konfigurieren, indem Sie einen entsprechenden SQLNET.ALLOWED_LOGON_VERSION-Wert in der Agent-Konfiguration festlegen.

Die folgenden Anweisungen gelten für den Agent, der On Premise ausgeführt wird:

1. Ändern Sie diese Datei /opt/oracle/mgmt_agent/agent_inst/config/emd.properties, um die Eigenschaft hinzuzufügen:

   dbaas.ALLOWED_LOGON_VERSION = 8 

   Die Werte können 8 / 10 / 11 /12 / 12a sein, abhängig von der zulässigen Anmeldeversion, die Sie benötigen.

2. Agent neu starten.

   sudo systemctl restart mgmt_agent

Diese Anweisungen gelten für den Agent, der auf OCI Compute ausgeführt wird:

1. Ändern Sie die Datei /var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/agent_inst/config/emd.properties, um diese Eigenschaft hinzuzufügen:

   dbaas.ALLOWED_LOGON_VERSION = 8

   Die Werte können 8 / 10 / 11 /12 / 12a sein, abhängig von der zulässigen Anmeldeversion, die Sie benötigen.

2. Agent neu starten.

   sudo systemctl restart oracle-cloud-agent

Anweisungen für das Oracle Database Discovery

• DB-System ermitteln, wenn Oracle Database bereits erkannt wurde
• Discovery-Eingabe
  • UI-Discovery-Eingabe
  • CLI-Discovery-Eingabe

DB-System ermitteln, wenn Oracle Database bereits erkannt wurde

1. UI-Discovery für das erste DB-System des Clusters:

   Füllen Sie auf der Seite Ressourcen-Discovery die leere Oracle Database-Discovery aus.

   Weitere Informationen zu UI-Discovery-Eingaben finden Sie in der Tabelle UI-Discovery-Eingabe.

2. CLI-Discovery für die restlichen DB-Systemressourcen:

   Hinweis
   
   Führen Sie für eine bereits erkannte Oracle Database die folgenden Schritte aus, um das zugehörige DB-System zu ermitteln.
   1. Navigieren Sie in der neu erstellten Oracle Database-Homepage zur Registerkarte Konfiguration. Kopieren Sie die folgenden Felder aus der Tabelle Allgemeine OCI-Eigenschaften in ein Notizbuch:

      Attributname	CLI-Variablenname	Hinweise
      OCID	<Database_Resource_OCID>
      compartmentId	<Compartment_OCID>
      managementAgentId	<Additional_Agent#_OCID>	Dies ist die OCID des Agent, der während der CLI-Discovery verwendet wird.

   2. Kopieren Sie den Namen der Oracle Database-Ressource oben auf der Homepage für Stackmonitoring von Oracle Database.
   3. Rufen Sie die Management Agent-OCID der anderen Knoten im Cluster ab:

      1. Navigieren Sie zu Observability and Management, gehen Sie zu Management-Agents, und klicken Sie auf Agents.

      2. Wählen Sie für jeden zusätzlichen Agent im DB-Systemcluster das Aktionsmenü aus.
      3. Wählen Sie OCID in Zwischenablage kopieren aus.

         Agent-OCID	CLI-Variablenname
         1. zusätzlicher Knoten im Cluster	<Additional_Agent1_OCID>
         2. zusätzlicher Knoten im Cluster (etc)	<Additional_Agent2_OCID>

   4. Aktualisieren Sie JSON_INPUT_FILE mit den abgerufenen Werten, und ermitteln Sie ein Oracle DB-System mit der folgenden Syntax:

      oci stack-monitoring discovery-job create --compartment-id "<Compartment_ID>" --from-json file://<JSON_INPUT_FILE>

   Weitere Informationen zu CLI-Discovery-Eingaben finden Sie in der Tabelle CLI-Discovery-Eingabe.

   Im Folgenden finden Sie Beispiele für JSON-Payloads, mit denen Sie die restlichen DB-Systemressourcen ermitteln können:

   {
     "discoveryType": "REFRESH",
     "discoveryClient": "APPMGMT",
     "compartmentId": "<COMPARTMENT_OCID>",
     "discoveryDetails": {
       "agentId": "<OCID of the Management agent>",
       "resourceType": "ORACLE_DATABASE",
       "resourceName": "<Resource name to display in Stackmonitoring UI>",
       "properties": {
         "propertiesMap": {
               "resource_id":"<DATABASE_OCID>",
               "asm_host":"<ASM HOSTNAME>",
               "asm_service_name":"+ASM",
               "is_asm_discovery":"true",
               "asm_port":"1521",
               "additional_agent_1":"ADDITIONAL_AGENT1_OCID",
               "additional_agent_2":"ADDITIONAL_AGENT2_OCID"
         }
       },
       "credentials": {
         "items": [
               {
             "credentialName" : "QVNNUGFzc3dvcmRJblZhdWx0",
             "credentialType" : "U1NMX1NFQ1JFVF9JRA==",
             "properties": {
               "propertiesMap": {
                 "ASMUserName": "<ASM user name in base64 encoded format>",
                 "PasswordSecretId": "<Encoded ASM user secret ocid in BASE64 encoded format>",
                 "ASMRole":"<ASM user role in base64 encoded format>"
               }
             }
           }
         ]
       }
     }
   }

Weitere Informationen zum Aktualisieren des Oracle DB-Systems finden Sie unter Aktualisierung der Oracle Database-Systemkomponenten.

Oracle Database

Oracle Database einschließlich Datenbanksystem mit der Benutzeroberfläche ermitteln: Füllen Sie auf der Seite Ressourcen-Discovery die leere Benutzeroberfläche aus, um eine Oracle Database einschließlich Datenbanksystem und deren Komponenten zu ermitteln.

Gehen Sie folgendermaßen vor, um mehrere Agents beim Erkennen eines Datenbanksystems für RAC mit mehreren Knoten einzuschließen:

Discovery-Eingabe

• UI-Discovery-Eingabe

  Eingabefeld	Beschreibung
  Ressourcenname	Name der Datenbank
  DNS-Hostname oder SCAN-Name	Domain Name System (DNS) oder Single Client Access Name (SCAN) für die Datenbank
  Port	Port, der von der Datenbank außerhalb von Oracle Cloud Infrastructure für Datenbankverbindungen verwendet wird
  Dienstname	Servicename für die Datenbank außerhalb von Oracle Cloud Infrastructure, der von der Verbindung verwendet wird
  Protokoll	Protokoll für die Oracle Database. Wählen Sie entweder das TCP- oder das TCPS-Protokoll aus
  Secret für Kennwort des Datenbankbenutzers in Compartment <compartment_name>	Wählen Sie das Secret mit dem Datenbankbenutzerkennwort in der Dropdown-Liste aus. Dieses Feld wird nur angezeigt, wenn im Feld Protokoll die Option TCPS ausgewählt ist. Siehe unten.
  Management Agents	Management Agents, die den Host überwachen, auf dem die Datenbank installiert ist Hinweis Wählen Sie für Datenbanksysteme, die mehrere Hosts umfassen, alle Management Agents aus, die auf allen Hosts des Datenbanksystems bereitgestellt sind.
  Datenbankzugangsdaten für Monitoring	.
  Benutzername	Benutzername der Oracle Database-Überwachungszugangsdaten
  Kennwort	Kennwort im 64-codierten Basisformat der Oracle Database-Überwachungszugangsdaten
  Rolle	Datenbankrolle im 64-codierten Basisformat des Datenbank-Monitoringbenutzers (Normal oder SYSDBA)
  ASM-Informationen
  Management Agent	Management Agent, der den Host überwacht, auf dem die Datenbank installiert ist. Zum Erkennen von Cluster- und Listener-Agent muss auf dem Datenbankhost installiert werden.
  Automatic Storage Manager	Aktivieren oder Deaktivieren. Standardmäßig aktiviert:
  DNS-Hostname oder Scanname	Der Standard-DNS- oder SCAN-Name, in dem sich die ASM-Instanz befindet.
  Port	Der von ASM verwendete Port. Standardwert: 1521
  Service-Name	Der ASM Service-Name
  ASM-Zugangsdaten für Monitoring
  Benutzername	ASM-Benutzername im Basis-64-codierten Format
  Secret für ASM-Kennwort im aktuellen Compartment	Kennwort-Secret im codierten Basisformat 64 gemäß Definition im OCI Vault-Service
  Rolle	Rolle im Basis-64-codierten Format. SYSMAN standardmäßig. Mögliche Werte: SYSASM, SYSDBA, SYSOPER
  Suchen in
  Stack Monitoring and Log Analytics (empfohlen)	Discovery-Ergebnisse werden an Stack Monitoring und Log Analytics gesendet. Hinweis Informationen zu Log Analytics finden Sie unter Schnellstart.
  Nur Stack Monitoring	Discovery-Ergebnisse werden nur an Stackmonitoring gesendet.
  Nur Log Analytics	Discovery-Ergebnisse werden nur an Log Analytics gesendet.
  License
  Enterprise Edition	Der Ressource wird eine Enterprise Edition-Lizenz zugewiesen.
  Standardedition	Der Ressource wird eine Standard Edition-Lizenz zugewiesen.
  Tags (unter Erweiterte Optionen anzeigen)	Freiformtags und definierte Tags können während der Discovery auf Stackmonitoringressourcen angewendet werden. Um definierte Tags zu verwenden, erstellen Sie zuerst die Tag-Namespaces. Siehe . Weitere Informationen zum Erstellen und Verwalten der Tag-Namespaces für definierte Tags finden Sie unter Tags und Tag-Namespace-Konzepte. Beim Erkennen einer Ressource werden alle zugewiesenen Tags auf alle erkannten Ressourcen angewendet. Weitere Informationen zu Tagvoraussetzungen und Tagpropagierung finden Sie unter Tags verwalten.
  Tag-Namespace	Wählen Sie "None" aus, um ein Freiformtag hinzuzufügen. Wählen Sie einen Namespace aus, um ein definiertes Tag im Namespace hinzuzufügen. Wenn Sie über Berechtigungen zum Erstellen einer Ressource verfügen, sind Sie auch berechtigt, Freiformtags auf diese Ressource anzuwenden. Um ein definiertes Tag zuzuweisen, benötigen Sie die Berechtigungen zum Verwenden des Tag-Namespace. Weitere Informationen zum Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Sie Tags anwenden sollten, überspringen Sie diese Option, oder fragen Sie Ihren Administrator. Sie können die Tags auch später noch anwenden.
  Tagschlüssel	Geben Sie den Namen an, mit dem Sie das Tag referenzieren.
  Tagwert	Geben Sie den Tagwert an. Weitere Details zu Tagschlüssel und Tagwert finden Sie unter Überblick über Tagging.

• CLI-Discovery-Eingabe

  CLI-Eingabevariable	Beschreibung
  <Additional_Agent1_OCID>	1. zusätzlicher Knoten im Cluster
  <Additional_Agent2_OCID> (etc)	2. zusätzlicher Knoten im Cluster (für jeden zusätzlichen Knoten im Cluster fortsetzen)
  Agent_OCID	Agent der anfänglichen Discovery-OCID
  Compartment_OCID	Die Compartment-OCID, in der das Oracle Database-System überwacht wird

Voraussetzungen

Wenn Sie Oracle WebLogic Server mit SSL aktiviert haben, exportieren Sie das Zertifikat aus seinem Keystore, und importieren Sie es in den Management Agent KeyStore. Weitere Informationen zum Konfigurieren von SSL in WebLogic Server finden Sie unter SSL konfigurieren.

Importieren Sie TrustStore in den Management Agent

1. Legen Sie im Dateisystem des Management Agent ein persistentes Unterverzeichnis für die Truststores und Keystores von Stack Monitoring fest. Exportieren Sie das Zertifikat aus dem JMX-SSL-Keystore der WLS-Instanz in den Stack Monitoring Truststore. Beispiel für einen UNIX-Host:

   keytool -exportcert -alias <alias of WLS SSL key> -file <Exported Cert Name> -keystore <path to the WLS SSL Keystore>.keystore -storepass <WLS SSL Keystore password> -rfc

2. Importieren Sie den JMX-SSL-Keystore der WLS-Instanz in den Stack Monitoring Truststore im Dateisystem des Management Agent:

   keytool -importcert -noprompt -alias <alias agent's truststore key> -file <Exported Cert Name>.cer -keystore AgentTrust.jks -storepass <Agent truststore password, default is "welcome">

3. Kopieren Sie die Truststore-Datei für Stack Monitoring, und aktualisieren Sie ihre Berechtigungen.

   Identifizieren Sie den lesbaren sicheren Speicherort des Management Agent auf dem Agent-Host.

   cp <path_to_truststore_file/AgentTrust.jks <secure_readable_dir>/

   Auf OCI Compute:

    sudo chown oracle-cloud-agent:oracle-cloud-agent <secure_readable_dir>/AgentTrust.jks

   On-Premise-Compute:

   sudo chown mgmt_agent:mgmt_agent <secure_readable_dir>/AgentTrust.jks

4. Verwenden Sie den vollständigen Truststore-Pfad, z.B. <secure_readable_dir>/AgentTrust.jks im "TrustStore-Pfad" der Ressourcen-Discovery, wenn die WebLogic-Domain T3S und "JKS" als "Truststore-Typ" aufweist.

MBeans auf Oracle WebLogic-Servern konfigurieren

Um die JVM-Performancemetriken von der Plattform MBeans zu erfassen, muss die MBeans über die Laufzeit MBeanServer zugänglich gemacht werden. Aktivieren Sie MBeans, indem Sie sich bei Oracle WebLogic Server anmelden und die Aktivierung prüfen, indem Sie das WLST-Skript ausführen:

1. Aktivieren Sie MBeans auf Oracle WebLogic-Servern

   Aktivieren Sie MBeans, indem Sie auf jeden Oracle WebLogic Server zugreifen, indem Sie sich wie folgt bei ihm oder über die WebLogic-Konsole anmelden:

   • Melden Sie sich bei Oracle WebLogic Server an:

     Befolgen Sie die Benutzeraktionen in der Demostrierung der WebLogic Scripting Tool-Session unter Activating Platform MBeans on WebLogic Server 9.x to 10.3.2 versions in Enterprise Manager Cloud Control Middleware Management Guide.

   • Greifen Sie auf die WebLogic-Konsole zu:

     Navigieren Sie zu Domain > Konfiguration > Seite Allgemein > Erweiterte Optionen. Aktivieren Sie das Kontrollkästchen Plattform MBean Server verwendet.

   Wenn MBeans nach den obigen Schritten nicht registriert ist, starten Sie die Oracle WebLogic-Server mit der folgenden Systemeigenschaft:

   -Djavax.management.builder.initial=weblogic.management.jmx.mbeanserver.WLSMBeanServerBuilder

2. Prüfen Sie die Aktivierung von MBeans.

   Um zu prüfen, ob MBeans erfolgreich aktiviert wurde, führen Sie das WLST-Skript aus, das unter Using the Platform MBean Server in Fusion Middleware Developing Custom Management Utilities With JMX for Oracle WebLogic Server verfügbar ist. Das WLST-Skript zeigt, wie Sie mit der Plattform MXBeans die Ressourcen einer ausgeführten Oracle WebLogic Server-Domain überwachen.

   Stellen Sie sicher, dass MBeans unter java.lang registriert ist.

Stellen Sie die Konnektivität zwischen Management Agent und allen Servern in WebLogic sicher

Während der Discovery kommuniziert der Stackmonitoring-Agent mit AdminServer, um die Domaintopologie zu ermitteln. Die Überwachung nach der Discovery erfolgt durch direkte Kommunikation mit Managed Servern. Prüfen Sie dazu Folgendes:

• Management Agent kann mit allen Managed Servern in der Domain kommunizieren.
• Der Agent kann auf den Host und die Ports der Managed Server zugreifen.
• Wenn Filter so konfiguriert sind, dass eingehender Traffic auf Managed Servern blockiert wird, passen Sie die Filter an, damit der Agent mit den Managed Servern kommuniziert.

WebLogic Szenariospezifische Discovery-Ergebnisse

1. Die WebLogic-Domain hat zwei Server, von denen einer heruntergefahren ist.

   Discovery-Ergebnis: Die Domain WebLogic wird nur mit dem Server erkannt, der sich im Status "Wird ausgeführt" befindet. Dabei wird der Server ignoriert, der sich nicht im Status "Wird ausgeführt" befindet.

2. Eine WebLogic-Domain verfügt über ein Cluster mit zwei Servern, von denen einer heruntergefahren ist.

   Discovery-Ergebnis: WebLogic Cluster wird nur mit dem Server erkannt, der sich in einem aktiven Status befindet.

3. Eine WebLogic-Domain hat ein Cluster, das nur einen Server enthält, der sich nicht im Ausführungsstatus befindet.

   Discovery-Ergebnis: Weder Cluster noch Server werden erkannt

WebLogic Discovery-Eingabe

EBS-Topologie

Wenn eine E-Business Suite-Instanz erkannt wird, werden sowohl EBS- als auch WebLogic-Ressourcen erkannt. OHS- und Datenbank-Discovery müssen separat ausgeführt werden.

Informationen zum Überwachen von in EBS untergebrachtem Oracle HTTP Server finden Sie unter "OHS Discovery". Nachdem OHS unabhängig erkannt wurde, kann eine Verknüpfung zwischen der EBS-Ressource und der OHS-Ressource erstellt werden.

Um die EBS-Datenbank zu überwachen, wird die Verknüpfung des Typs verwendet zwischen der EBS-Ressource und der Datenbankressource am Ende der EBS-Discovery automatisch erstellt, wenn die Datenbank zuerst erkannt und dann später erkannt wird. Hier bezieht sich die EBS-Ressource auf den Ressourcentyp ebs_instance für Stackmonitoring, und die Datenbankressource bezieht sich auf den Ressourcentyp oci_oracle_db oder oci_oracle_pdb für Stackmonitoring.

Wenn EBS vor der Datenbank-Discovery erkannt wird, kann die Topologie auf zwei Arten aktualisiert werden.

• Verknüpfung zwischen EBS-Instanz und Datenbankressourcen erstellen
• EBS-Topologie wird aktualisiert

Verknüpfungen erstellen:

Composite-EBS-Ressourcen können nicht direkt mit einem Host verknüpft werden. Untergeordnete EBS-Ressourcen können jedoch wie folgt verknüpft werden:

• EBS Concurrent Manager verwendet Host
• EBS CP-Knoten verwendet Host

Im Folgenden finden Sie die OCI-CLI-Befehlssyntax zum Erstellen einer Verknüpfung zwischen zwei Ressourcen.

oci stack-monitoring resource associate --association-type uses --compartment-id "<Compartment_OCID>" --source-resource-id "<Resource_OCID>" --destination-resource-id "<Database_Resource_OCID>"

Beispiele:

oci stack-monitoring resource associate --association-type uses --<Compartment_OCID>
      ocid1.compartment.oc1..unique_ID --<Source_Resource_OCID>
      ocid1.stackmonitoringresource.oc1.iad.unique_ID --<Destination_Resource_OCID>
      ocid1.stackmonitoringresource.oc1.iad.unique_ID

Bei EBS kann der oben genannte Befehl verwendet werden, um eine Verknüpfung zwischen EBS und Datenbankressourcen zu erstellen, indem <Source_Resource_OCID> als EBS-Ressourcen-ID und <Destination_Resource_OCID> als Datenbankressourcen-ID angegeben wird.

Eine EBS-Discovery, die mit den zugrunde liegenden Ressourcen verknüpft ist, wird in Stack Monitoring dargestellt, wie im folgenden Diagramm dargestellt:

Voraussetzungen

1. MBeans auf Oracle WebLogic-Servern konfigurieren
2. Erfassung von Forms-Sessions-Daten prüfen
3. DNS in einer Oracle E-Business Suite-Umgebung einrichten
4. Fügen Sie die von der E-Business Suite-Anwendung verwendete Datenbank hinzu.

   Falls noch nicht geschehen, fügen Sie die Datenbank hinzu, die für die E-Business Suite-Anwendung verwendet wird. Siehe Oracle Database (Discovery)

5. Agent-Berechtigungen für Application Listener-Überwachung
6. E-Business Suite-Datenbanküberwachungsanforderungen für Stackmonitoring

Erfassung von Forms-Sessions-Daten prüfen

Prüfen Sie die Zusammenstellung der Forms-Sitzungsdaten, um sie später in den Forms-System-Ressourcenmetriken anzuzeigen, indem Sie die folgende Aufgabe ausführen. Dies gilt zusätzlich zu den Schritten, die in der Oracle WebLogic-Domain ausgeführt werden (MBeans auf Oracle WebLogic-Servern konfigurieren). Wenn dieser Schritt nicht konfiguriert ist, werden einige der Forms-Systemmetriken nicht erfasst.

Wenn Sie sich bei Oracle E-Business Suite anmelden, erstellt das System eine Benutzersession in der Datenbank, die durch eine eindeutige Session-ID (SID) mit den Zugangsdaten des APPS-Schemas identifiziert wird. Jede Datenbank-Session ist mit einem Oracle E-Business Suite-Anwendungsbenutzer verknüpft. Dies ermöglicht die Verknüpfung der Datenbanksession mit dem Anwendungsbenutzer zu Fehlerbehebungszwecken. Mit einer Forms-Session können Sie bestimmen, wie der Oracle E-Business Suite-Benutzer eine Datenbank-Session geöffnet hat.

1. Melden Sie sich bei Oracle E-Business Suite an.
2. Navigieren Sie in der Benutzeroberfläche zu Systemadministrator, und klicken Sie auf Profil, System.
3. Stellen Sie sicher, dass der Wert von Anmeldung: Auditebene auf FORM gesetzt ist. Legen Sie dies auf Standortebene fest.
4. Stellen Sie sicher, dass der Wert von AuditTrail: Activate auf YES gesetzt ist.

Speichern Sie die Änderungen.

DNS in einer Oracle E-Business Suite-Umgebung einrichten

Die Oracle E-Business Suite-Hosts müssen in der Lage sein, einander im Netzwerk zu erkennen. Beispiel: In der UNIX-Umgebung werden die DNS-Server in der Datei /etc/resolv.conf auf jedem Host konfiguriert.

Um zu prüfen, ob die DNS-Server korrekt konfiguriert sind, führen Sie den folgenden Befehl aus:

nslookup any_publicDomain_hostname

Ersetzen Sie <any_publicDomain_hostname> durch den Hostnamen eines anderen Hosts der EBS-Umgebung außer dem localhost.

Im Folgenden finden Sie ein Beispiel für eine erfolgreiche Ausgabe, die bestätigt, dass der DNS-Server korrekt konfiguriert ist:

$ nslookup node02.examplehost.com

Server:         937.486.274.354
Address:        937.486.274.354

Non-authoritative answer:
Name:   node02.examplehost.com
Address: 135.756.247.46

Agent-Berechtigungen für Application Listener-Überwachung

Agent muss auf demselben Host wie EBS installiert sein, um den EBS Application Listener zu überwachen. Andernfalls wird die Ressource immer als DOWN angezeigt.

Stellen Sie sicher, dass der Benutzer mgmt_agent oder oracle-cloud-agent basierend auf dem installierten Agent-Typ in der Oracle Inventory-Gruppe (in der Regel oinstall) von /etc/oraInst.loc enthalten ist, um die Befehle lsnrctl, srvctl und crsctl ausführen zu können.

Verwenden Sie die folgende Anweisung, um dem Benutzer mgmt_agent oder oracle-cloud-agent oinstall-Berechtigungen basierend auf dem installierten Agent-Typ zu erteilen:

• Host mit Oracle Cloud Agent: usermod -aG oinstall oracle-cloud-agent
• Host mit Standalone-Agent: usermod -aG oinstall mgmt_agent

Beispiel für das Hinzufügen der Gruppenausführungsberechtigung zum Verzeichnis:

chmod -R g+x+r /u01/install/APPS

Verwenden Sie nach Erteilen der BS-Berechtigungen die folgenden Anweisungen, um den Agent neu zu starten. Verwenden Sie die entsprechenden Anweisungen für Ihren Agent bzw. Ihr Betriebssystem:

1. Agent stoppen
   • Oracle Linux 6:
     • Oracle Cloud-Agent: sudo /sbin/initctl stop oracle-cloud-agent
     • Standalone-Agent: sudo /sbin/initctl stop mgmt_agent
   • Oracle Linux 7
     • Oracle Cloud-Agent: sudo systemctl stop oracle-cloud-agent
     • Standalone-Agent: sudo systemctl stop mgmt_agent
2. Starten Sie den Agent mit dem Startbefehl.

E-Business Suite-Datenbanküberwachungsanforderungen für Stackmonitoring

Die Oracle-Datenbank, mit der die E-Business Suite-(EBS-)Datenbank überwacht wird, muss erkannt werden, bevor die EBS-Anwendung erkannt wird. Wenn die Datenbank zuerst erkannt wird, wird sie automatisch mit der EBS-Anwendung verknüpft, sobald die EBS-Anwendungserkennung abgeschlossen ist. Wenn die EBS-Anwendungs-Discovery ausgeführt wird, bevor die Datenbank erkannt wurde, muss die Verknüpfung manuell erstellt werden.

Die Überwachung der E-Business Suite erfordert bestimmte Berechtigungen für den Zugriff auf das EBS-Schema. Das Setup unterscheidet sich je nach Datenbanktyp (Nicht-Container-DB im Vergleich zu Container-DB und integrierbarer DB), der als EBS-Datenspeicher verwendet wird. Stackmonitoring unterstützt die Verwendung des EBS-Schemaeigentümers, in der Regel APPS, als Datenbankzugangsdaten beim Erkennen von EBS. Es wird bevorzugt, einen Überwachungsbenutzer mit nur den Berechtigungen zu erstellen, die zum Überwachen einer EBS-Anwendung erforderlich sind. Sie können denselben Datenbankbenutzer verwenden, um sowohl die Oracle-Datenbank mit dem EBS-Schema als auch die EBS-Anwendung zu überwachen. Schritte zum Erstellen eines Datenbanküberwachungsbenutzers finden Sie im MOS-Hinweis: 2857604.1.

Datenbankzugriffsberechtigungen

Die spezifischen Berechtigungen werden im folgenden Code definiert. Es wird der EBS-Schemaname APPS vorausgesetzt. Wenn der Schemaname in Ihrem Setup nicht identisch ist, ersetzen Sie APPS durch den tatsächlichen Schemanamen im folgenden Code.

Um zu prüfen, ob der Überwachungsbenutzer über die erforderlichen Berechtigungen verfügt, und fehlende Berechtigungen anzuwenden, führen Sie die folgenden EBS-Skripte aus.

Informationen zu den spezifischen Berechtigungen, die angewendet werden sollen, oder zum manuellen Anwenden der Berechtigungen finden Sie in der folgenden Liste der auszuführenden Befehle.

Ersetzen Sie <your_monitoring_user> durch den Datenbanküberwachungsbenutzer, der mit dem Skript erstellt wurde. Stellen Sie sicher, dass die Berechtigungen auf den Überwachungsbenutzer angewendet werden, in dem sich das Schema APPS befindet.

GRANT SELECT ON APPS.FND_OAM_CONTEXT_FILES TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_PRODUCT_GROUPS TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONC_PROG_ONSITE_INFO TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONCURRENT_PROGRAMS_VL TO <your_monitoring_user>;
GRANT EXECUTE ON APPS.FND_OAM_EM TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONCURRENT_REQUESTS TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_APPLICATION_VL TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONCURRENT_QUEUES TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_LOOKUPS TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONCURRENT_WORKER_REQUESTS TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONCURRENT_QUEUES_VL TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_OAM_FNDUSER_VL TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_FORM_SESSIONS_V TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CP_SERVICES TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONCURRENT_PROCESSES TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_SVC_COMPONENTS TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_LOG_MESSAGES TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_CONCURRENT_PROGRAMS TO <your_monitoring_user>; 
GRANT SELECT ON APPS.FND_CONFLICTS_DOMAIN TO <your_monitoring_user>; 
GRANT SELECT ON APPS.FND_ORACLE_USERID TO <your_monitoring_user>; 
GRANT SELECT ON APPS.FND_APP_SERVERS TO <your_monitoring_user>; 
GRANT SELECT ON APPS.FND_NODES TO <your_monitoring_user>;
GRANT SELECT ON APPS.ICX_SESSIONS TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_USER TO <your_monitoring_user>;
GRANT SELECT ON APPS.FND_RESPONSIBILITY TO <your_monitoring_user>;
GRANT EXECUTE ON APPS.FND_PROFILE TO <your_monitoring_user>;
GRANT SELECT ON APPS.WF_DEFERRED TO <your_monitoring_user>;
GRANT SELECT ON APPS.WF_NOTIFICATION_IN TO <your_monitoring_user>;
GRANT SELECT ON APPS.WF_NOTIFICATION_OUT TO <your_monitoring_user>;

Melden Sie sich bei der Datenbank an, die das EBS-Schema als SYSTEM-Benutzer enthält, und führen Sie die folgende Berechtigung aus:

GRANT INHERIT PRIVILEGES ON USER <your_monitoring_user> TO APPS

Melden Sie sich außerdem als Benutzer mit SYSDBA-Berechtigungen an, und führen Sie Folgendes aus:

SQL> GRANT CREATE SESSION TO <your_monitoring_user>

Beispiel:

SQL> GRANT CREATE SESSION TO C##STACKMONITOR

Wenn eine der Berechtigungen fehlt, wird die Auswirkung wie folgt beschrieben:

E-Business Discovery-Eingabe

PeopleSoft-Datenbank erkennen

Das Oracle Database-Schema mit dem PeopleSoft-(PSFT-)Schema muss erkannt werden, bevor die Anwendung PeopleSoft erkannt wird. Wenn die Datenbank zuerst erkannt wird, wird sie automatisch mit der Anwendung PeopleSoft verknüpft, sobald die Ressourcen-Discovery PeopleSoft abgeschlossen ist.

Wenn die Anwendungs-Discovery PeopleSoft ausgeführt wird, bevor die Datenbank erkannt wurde, muss die Verknüpfung manuell erstellt werden. Weitere Informationen finden Sie unter Anwendungstopologie.

Informationen zum Erkennen von Oracle Database finden Sie unter Oracle Database.

DB-Berechtigungen für Monitoring von PeopleSoft

Die Überwachung von PeopleSoft (PSFT) erfordert bestimmte Berechtigungen für den Zugriff auf das PSFT-Datenbankschema. Das Setup unterscheidet sich je nach Datenbanktyp (Nicht-Container-DB im Vergleich zu Container-DB und Integrierbare DB), der als PSFT-Datenspeicher verwendet wird. Stackmonitoring unterstützt die Verwendung des PSFT-Schemaeigentümers, in der Regel SYSADM, als Datenbankzugangsdaten beim Ermitteln von PSFT. Es wird bevorzugt, einen Überwachungsbenutzer mit nur den Berechtigungen zu erstellen, die zum Überwachen einer PSFT-Anwendung erforderlich sind. Sie können denselben Datenbankbenutzer verwenden, um sowohl die Oracle-Datenbank mit dem Schema PeopleSoft als auch die Anwendung PeopleSoft zu überwachen. Schritte zum Erstellen eines Datenbanküberwachungsbenutzers finden Sie im MOS-Hinweis: 2857604.1.

So prüfen Sie, ob der Monitoringbenutzer über die erforderlichen Berechtigungen verfügt, und wenden fehlende Berechtigungen an:

1. Stellen Sie sicher, dass der Monitoringbenutzer nicht abgelaufen ist:
   1. Prüfen Sie den Monitoringbenutzerstatus, indem Sie Folgendes ausführen:

      select username, account_status from dba_users where username='<your_monitoring_user>'

   2. Wenn der Monitoringbenutzer EXPIRED anzeigt, setzen Sie das Kennwort zurück.
2. Führen Sie die folgenden PeopleSoft-Skripte aus.

Informationen zu den spezifischen Berechtigungen, die angewendet werden sollen, oder zum manuellen Anwenden der Berechtigungen finden Sie in der folgenden Liste der auszuführenden Befehle.

Datenbankberechtigungen

• PeopleSoft Anwendungsberechtigungen

  GRANT SELECT ON SYSADM.PSSTATUS TO <your_monitoring_user>;
  GRANT SELECT ON SYSADM.PSRELEASE TO <your_monitoring_user>;
  GRANT SELECT ON SYSADM.PSPMAGENT TO <your_monitoring_user>;

• PeopleSoft Anwendungssynonyme

  CREATE OR REPLACE SYNONYM <your_monitoring_user>.PSSTATUS FOR SYSADM.PSSTATUS;
  CREATE OR REPLACE SYNONYM <your_monitoring_user>.PSRELEASE FOR SYSADM.PSRELEASE;
  CREATE OR REPLACE SYNONYM <your_monitoring_user>.PSPMAGENT FOR SYSADM.PSPMAGENT;

• Suchmaschinenberechtigungen

  Hinweis
  
  Die Suchmaschine unterstützt sowohl Elasticsearch als auch OpenSearch.

  GRANT SELECT ON SYSADM.PS_PTSF_SRCH_ENGN TO <your_monitoring_user>;

• Suchmaschinen-Synonyme

  Hinweis
  
  Die Suchmaschine unterstützt sowohl Elasticsearch als auch OpenSearch.

  CREATE OR REPLACE SYNONYM <your_monitoring_user>.PS_PTSF_SRCH_ENGN FOR SYSADM.PS_PTSF_SRCH_ENGN

• Berechtigungen für Prozessüberwachung

  GRANT SELECT ON SYSADM.PSPRCSRQST TO <your_monitoring_user>;
  GRANT SELECT ON SYSADM.PSXLATITEM TO <your_monitoring_user>;

• Synonyme für Prozessüberwachung

  CREATE OR REPLACE SYNONYM <your_monitoring_user>.PSPRCSRQST FOR SYSADM.PSPRCSRQST;
  CREATE OR REPLACE SYNONYM <your_monitoring_user>.PSXLATITEM FOR SYSADM.PSXLATITEM;

PeopleSoft Performance Monitor for Pure Internet Architecture (PIA) aktivieren

1. Navigieren Sie zu PeopleTools, gehen Sie zu Webprofil, klicken Sie auf Webprofilkonfiguration, und suchen Sie nach dem verwendeten Profil, z.B. PROD.
2. Wenn dies noch nicht aktiviert ist, aktivieren Sie das Kontrollkästchen PPM-Agent aktivieren.
3. Starten Sie alle PIA-Domains neu.

Voraussetzungen für Application Server- und Process Scheduler-Domains

PeopleSoft Performance Monitor Agent aktivieren

1. Wählen Sie in der Befehlszeilenschnittstelle PSADMIN "Application Server" (Option 1) oder "Process Scheduler" (Option 2) > Domain verwalten (Option 1) > "domain" > Menü "Konfiguration bearbeiten/Logdateien" (Option 6) > "Domainkonfigurationsdatei bearbeiten" (Option 1) aus. Dadurch werden die Domainkonfigurationsdateien im Bearbeitungsmodus geöffnet

2. Prüfen Sie im Abschnitt PSTOOLS den Wert für EnablePPM Agent. Legen Sie unter PPM-Agents aktivieren den Wert auf 1 fest, und speichern Sie die Datei.

JMX-Agents aktivieren

Mit dieser Voraussetzung kann Stack Monitoring Verfügbarkeits- und Performancedaten für eine PeopleSoft-Anwendung erfassen.

1. Wählen Sie in der Befehlszeilenschnittstelle PSADMIN "Application Server" (Option 1) oder "Process Scheduler" (Option 2) > Domain verwalten (Option 1) > "domain" > Menü "Konfiguration bearbeiten/Logdateien" (Option 6) > "Domainkonfigurationsdatei bearbeiten" (Option 1) aus. Dadurch werden die Domainkonfigurationsdateien im Bearbeitungsmodus geöffnet

2. Suchen Sie den Abschnitt Einstellungen für PSTOOLS, und legen Sie unter Werte fest

   1. Stellen Sie sicher, dass der Remote-Administrationsport, den Sie verwenden möchten, von keinem anderen Prozess auf dem Host verwendet wird.

   2. UserID

      • UserId muss im Textformat sein.

      • Dieselbe UserId und dasselbe Kennwort müssen für alle Anwendungsserverdomains und Prozessplanerdomains verwendet werden.

   3. Verwenden Sie das Utility PSCipher, um das Kennwort zu verschlüsseln.
   4. Starten Sie die Application Server- und Process Scheduler-Domains neu, nachdem Sie unten die Änderung der Performance Collator-Eigenschaft konfiguriert haben.

3. • Für PSFT Version 8.59 und frühere Versionen muss nur der Remote-Administrationsport festgelegt werden. Der RMI-Portwert wird automatisch basierend auf dem Wert des Remote-Administrationsportes festgelegt, der um 1 erhöht wird. Beispiel: Wenn der Remote-Administrationsport 10100 ist, wird Port 10101 für den RMI-Server von PHC verwendet. Wenn Sie die Portnutzung planen, muss dies berücksichtigt werden. Da 10101 automatisch im obigen Beispiel ausgewählt wird, wenn dieser Port nicht kostenlos ist, wählt PSFT automatisch einen anderen beliebigen freien Port aus. Prüfen Sie die Domainkonfigurationsdatei, nachdem die Konfiguration erfolgreich gespeichert wurde, und verwenden Sie diese Ports, um eine Verbindung bei der Discovery herzustellen.

     Beispiel:

     Enable Remote Administration=1
     Remote Administration Port=10100
     Remote Administration UserId=<the userid you have defined in step 2b>
     Remote Administration Password={V2.1}<encrypted password>

   • Ab PSFT Version 8.60 wird der RMI-Port durch einen zusätzlichen Parameter in der Konfigurationsdatei gesteuert. Stellen Sie sicher, dass der Wert explizit festgelegt ist. Starten Sie die Application Server- und Process Scheduler-Domains neu, nachdem Sie die Performance Collator-Eigenschaft konfiguriert haben.

     Beispiel:

     Enable Remote Administration=1
     Remote Administration Port=10100
     Remote Administration RMI Server Port=10101
     Remote Administration UserId=<the userid you have defined in step 2b>
     Remote Administration Password={V2.1}<encrypted password>

   Hinweis
   
   Stellen Sie sicher, dass die oben gespeicherte Einstellung nach dem Speichern der Änderungen korrekt in der Konfigurationsdatei angezeigt wird.

Performance Collator-Eigenschaft aktivieren

Sie können den aktuellen Wert von "Perf Collator" in den Domainvorlagendateien psprcsrv.ubx (Process Scheduler) und psappsrv.ubx (Application Server) unter $PS_CFG_HOME prüfen.

Wenn der Perf Collator aktiviert ist, wird der Eintrag wie folgt angezeigt.

{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [y]:

Wenn der Perf Collator deaktiviert ist, wird der Eintrag wie folgt angezeigt.

{PPM} Do you want Performance Collators configured (PSPPMSRV) (y/n)? [n]:

Wenn der Performance Collator bereits aktiviert ist und Änderungen an den EnablePPM Agent- oder JMX-Werten implementiert wurden: Starten Sie alle Domains neu.

Wenn der Performance Collator nicht bereits aktiviert ist, gehen Sie wie folgt vor:

1. Wählen Sie in der Befehlszeilenschnittstelle PSADMIN den Anwendungsserver (Option 1) oder Process Scheduler (Option 2) > Domain verwalten (Option 1) > Domain auswählen > Diese Domain konfigurieren (Option 4)
2. Geben Sie y für die Frage ein: Do you want to continue (y/n). Mit dieser Option wird die Domain heruntergefahren

3. Prüfen Sie den Wert der Eigenschaft Perf Collator.

4. Wenn der Wert auf Yes gesetzt ist, ist Collator bereits aktiviert, ist keine Aktion erforderlich. Wählen Sie dann "Konfiguration laden" (Option 14 für Application Server oder Option 7 für Process Scheduler)

5. Wenn der Wert auf No gesetzt ist, geben Sie 10 für den Anwendungsserver ein, oder Option 3, damit der Prozess-Scheduler den Wert in Yes umschalten kann

6. Nachdem Sie bestätigt haben, dass der Perf Collator auf Yes gesetzt ist, wählen Sie Konfiguration laden aus (Option 14 für den Anwendungsplaner oder Option 7 für den Prozessplaner).

7. Wählen Sie schließlich "Diese Domain booten" Option 1, um die Domain zu starten

Zu ermittelnde Domains identifizieren

Stackmonitoring verwendet die in Oracle Database gespeicherten Informationen, um Domains zu identifizieren, die erkannt oder aktualisiert werden sollen. Um die Liste der aktuellen Domains zu validieren, führen Sie die folgende Abfrage aus.

SELECT * FROM PSPMAGENT;

Alle von der Abfrage zurückgegebenen Domains, die nicht mehr vorhanden sind, müssen entfernt werden, bevor die Anwendung PeopleSoft erkannt/aktualisiert wird.

Informationen zum Hinzufügen einer nicht aufgeführten Domain finden Sie unter Manuelles Hinzufügen von Domains.

Um die veralteten Domains zu entfernen, führen Sie die folgende SQL-Anweisung als SYSADM oder gleichwertiger Benutzer aus. Wiederholen Sie die Schritte, bis alle veralteten Domains entfernt wurden.

• Sichern Sie die Tabelle PSPMAGENT, bevor Sie Änderungen vornehmen. Stellen Sie sicher, dass Sie <DATE> durch den aktuellen Zeitstempel ersetzen.

  create table PSPMAGENT_BKP_<DATE> as select * from PSPMAGENT;

• Stellen Sie sicher, dass die erstellte Backup-Tabelle denselben Inhalt wie die übergeordnete Tabelle aufweist.

  select * from PSPMAGENT
  MINUS
  select * from PSPMAGENT_BKP_<DATE>;

Wenn die Anzahl der Zeilen aus PSPMAGENT mit PSPMAGENT_BKP_<DATE> übereinstimmt, fahren Sie mit dem Entfernen veralteter Domains fort.

delete from PSPMAGENT WHERE PM_AGENTID='&enter_agent_id_of_stale_domain';
Commit;

Domains manuell hinzufügen

Prüfen Sie schließlich, ob alle gültigen Domains in der Tabelle PSPMAGENT sichtbar sind. Wenn aus irgendeinem Grund keine gültigen Domains angezeigt werden, befolgen Sie die folgenden Anweisungen:

Backup erstellen:

1. Führen Sie als Systemadministrator oder gleichwertiger Benutzer ein Backup der Tabelle durch, bevor Sie Änderungen vornehmen. Stellen Sie sicher, dass <DATE> durch den aktuellen Zeitstempel ersetzt wird:

   create table PSPMAGENT_BKP_<DATE> as select * from PSPMAGENT;

2. Stellen Sie sicher, dass die erstellte Backup-Tabelle denselben Inhalt wie die übergeordnete Tabelle aufweist. Die Zeilenanzahl aus PSPMAGENT muss mit der Zeilenanzahl aus PSPMAGENT_BKP_<DATE> übereinstimmen:

   select * from PSPMAGENT
   MINUS
   select * from PSPMAGENT_BKP_<DATE>;

Process Scheduler-Domain hinzufügen

INSERT INTO  PSPMAGENT values
('&AGENT_ID','&PM_JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','04','&DOMAIN_DIR','Y','&HOST_PORT:','1','1','N');

Beispiel:

SQL>  INSERT INTO  PSPMAGENT values
('&AGENT_ID','&PM_JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','04','&DOMAIN_DIR','Y','&HOST_PORT:','1','1','N');  2 
Enter value for unique_agent_id: 1000
Enter value for pm_jmx_rmi_port: 10500
Enter value for domain_name: PRCSDOM02
Enter value for domain_dir: /u01/app/oracle/product/psfthcm-midtierlinux-2/ps_cfg_home/appserv/prcs/PRCSDOM02
Enter value for host_name: psfthcm-midtierlinux-2
old   2: ('&unique_agent_id','&PM_JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','04','&domain_dir','Y','&host_name:','1','1','N')
new   2: ('1000','10500','PSMONITORSRV','PRCSDOM02','04','/u01/app/oracle/product/psfthcm-midtierlinux-2/ps_cfg_home/appserv/prcs/PRCSDOM02','Y','psfthcm-midtierlinux-2:','1','1','N')
  
1 row created.

Anwendungsserverdomain hinzufügen

INSERT INTO  PSPMAGENT values
('&unique_agent_id','&JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','01','&DOMAIN_DIR','Y','&host_name:&jolt_port','1','1','N');

Beispiel:

SQL> INSERT INTO  PSPMAGENT values
('&unique_agent_id','&JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','01','&DOMAIN_DIR','Y','&host_name:&jolt_port','1','1','N');   2 
Enter value for unique_agent_id: 1003
Enter value for jmx_rmi_port: 10500
Enter value for domain_name: APPDOM4
Enter value for domain_dir: /u01/app/oracle/product/psfthcm-midtierlinux-3/ps_cfg_home/appserv/APPDOM04
Enter value for host_name: psfthcm-midtierlinux-3
Enter value for jolt_port: 9033
old   2: ('&unique_agent_id','&JMX_RMI_PORT','PSMONITORSRV','&DOMAIN_NAME','01','&DOMAIN_DIR','Y','&host_name:&jolt_port','1','1','N')
new   2: ('1003','10500','PSMONITORSRV','APPDOM4','01','/u01/app/oracle/product/psfthcm-midtierlinux-3/ps_cfg_home/appserv/APPDOM04','Y','psfthcm-midtierlinux-3:9033','1','1','N')

PIA-Server hinzufügen

INSERT INTO  PSPMAGENT values
('&unique_agent_id','-1','WEBRESOURCE','&DOMAIN_NAME','02','&DOMAIN_DIR','Y','&host_name:&http_port:&https_port','1','1','N');

Beispiel:

INSERT INTO  PSPMAGENT values
('&unique_agent_id','-1','WEBRESOURCE','&DOMAIN_NAME','02','&DOMAIN_DIR','Y','&host_name:&http_port:&https_port','1','1','N');
Enter value for unique_agent_id: 19
Enter value for domain_name: peoplesoft03
Enter value for domain_dir: /u01/app/oracle/product/psfthcm-midtierlinux-3/ps_cfg_home/webserv/WEBSERVER/peoplesoft03
Enter value for host_name: psfthcm-midtierlinux-3
Enter value for http_port: 9000
Enter value for https_port: 9001
old   2: ('&unique_agent_id','-1','WEBRESOURCE','&DOMAIN_NAME','02','&DOMAIN_DIR','Y','&host_name:&http_port:&https_port','1','1','N')
new   2: ('19','-1','WEBRESOURCE','peoplesoft03','02','/u01/app/oracle/product/psfthcm-midtierlinux-3/ps_cfg_home/webserv/WEBSERVER/peoplesoft03','Y','psfthcm-midtierlinux-3:9000:9001','1','1','N')
  
1 row created.

Suchmaschinen-Discovery in PeopleSoft aktivieren

Die Suchmaschinenerkennung ist optional und unterstützt sowohl Elasticsearch als auch OpenSearch. Wenn die Suchmaschine bereits integriert ist, können Sie sie in die erste Entdeckung aufnehmen. Um die Suchmaschine in Zukunft zu integrieren, verwenden Sie den PeopleSoft-CLI-Befehl refresh, und fügen Sie dem Überwachungsbenutzer die Berechtigungen für die Suchmaschinen-DB hinzu. Weitere Informationen zu Berechtigungen finden Sie unter DB Grant-Berechtigungen für PeopleSoft Monitoring. Weitere Informationen zu CLI-Aktualisierungsbefehlen finden Sie unter PeopleSoft Refresh.

grep JAVA_HOME emd.properties
JAVA_HOME=/var/lib/oracle-cloud-agent/plugins/oci-managementagent/polaris/jdk1.8.0_371-b11

Diese Voraussetzungen ermöglichen die Integration der Suchmaschine in PeopleSoft:

• Stack Monitoring unterstützt nur die Überwachung der mit SSL konfigurierten Suchmaschine. Der Endpunkt muss HTTPS sein. Weitere Informationen zum Setup finden Sie unter SSL für Elasticsearch konfigurieren bzw. SSL für OpenSearch konfigurieren.

• Erstellen Sie vor der Erkennung der Suchmaschine einen JKS-Truststore, da JKS der einzige unterstützte Typ von Trust Stores ist, auf dem Host des Überwachungsagenten, um das Zertifikat von der Suchmaschine zu speichern. Der Speicherort und das Kennwort dieses Truststore sind erforderliche Parameter in der Discovery-UI oder in der Discovery-JSON bei der Discovery über die CLI, während der Truststore-Speicherort auf dem Agent-Host zugänglich sein muss.

  Beispiel:

  keytool -keystore truststore.jks -alias <ALIAS> -import -file <SEARCH ENGINE CERTIFICATE>

Process Monitor-Discovery für PeopleSoft aktivieren

• Process Monitor wird neben PeopleSoft erkannt und ist standardmäßig beim Erkennen einer PeopleSoft-Anwendung aktiviert. Wenn Sie im Abschnitt Prozessmonitor ermitteln die Option Nein auswählen, wird Process Monitor nicht in die Discovery PeopleSoft aufgenommen.
• Process Monitor-Discovery ist optional. Wenn Process Monitor bereits aktiviert ist, können Sie es in die erste Discovery aufnehmen. Um Process Monitor zukünftig zu integrieren, verwenden Sie den PeopleSoft-CLI-Befehl refresh, und fügen Sie dem Monitoringbenutzer die Prozessmonitor-DB-Berechtigungen hinzu. Weitere Informationen zu Berechtigungen finden Sie unter DB Grant-Berechtigungen für PeopleSoft Monitoring. Weitere Informationen zu CLI-Aktualisierungsbefehlen finden Sie unter PeopleSoft Refresh.

• Für die Process Monitor-Erkennung sind keine Eigenschaften erforderlich

• Benutzeroberfläche

  • Process Monitor-Discovery ist standardmäßig enthalten. Um ein Opt-out vorzunehmen, wählen Sie im Bereich Ressourcen-Discovery unter Prozessmonitor ermitteln die Option Nein aus.

Voraussetzungen

• JMX-Überwachung aktivieren. Siehe JMX-Remote aktivieren.
  Hinweis
  
  Das Tomcat-Monitoring unterstützt SSL nicht. SSL wird standardmäßig deaktiviert, wenn Sie der Tomcat-Dokumentation folgen.

Eingabe für Apache Tomcat Discovery

Weitere Informationen zu Eingabeparametern finden Sie unter JSON-Eingabeparameter

Voraussetzungen

Benutzerdefinierten Datenbankbenutzer erstellen

Um die Überwachung für eine Microsoft SQL Server-Datenbank zu aktivieren, können Sie wie folgt einen speziellen Datenbankbenutzer erstellen.

Erstellen Sie einen Benutzer (z.B. monstk), und ordnen Sie den neuen Benutzer den Master- und msdb-Datenbanken zu. Erteilen Sie diesem Benutzer dann die folgenden Mindestberechtigungen.

CREATE LOGIN monstk
WITH PASSWORD = 'monstk1;123';
GO
CREATE USER monstk FOR LOGIN monstk;
GO

Ordnen Sie den Benutzer allen System- und Benutzerdatenbanken zu:

USE master;
CREATE USER monstk FOR LOGIN monstk;
GRANT VIEW ANY DATABASE TO monstk;
GRANT VIEW ANY definition TO monstk;
GRANT VIEW server STATE TO monstk;

GRANT EXECUTE ON sp_helplogins TO monstk;
GRANT EXECUTE ON sp_readErrorLog TO monstk;
GRANT EXECUTE ON dbo.xp_regread TO monstk;

GRANT CREATE FUNCTION TO [monstk];
GRANT CONTROL TO [monstk];
GRANT CREATE TABLE TO [monstk];
GRANT SELECT ON [sys].[sysaltfiles] TO [monstk];

USE msdb;
GRANT SELECT ON dbo.sysjobsteps TO monstk;
GRANT SELECT ON dbo.sysjobs TO monstk;
GRANT SELECT ON dbo.sysjobhistory TO monstk;

Eingabe für MS SQL Server Discovery

Voraussetzungen

WebLogic muss erkannt werden, bevor Managed File Transfer (MFT) erkannt wird. Wenn Sie MFT ermitteln, wählen Sie in der Discovery-UI die entsprechende WebLogic aus der Dropdown-Liste aus.

Datenbankmonitoringanforderungen für Stackmonitoring

Die Oracle-Datenbank muss erkannt werden, bevor die MFT-Anwendung erkannt wird. Wenn die Datenbank zuerst erkannt wird, wird sie automatisch mit der MFT-Anwendung verknüpft, sobald das Discovery der MFT-Anwendung abgeschlossen ist. Wenn das Discovery der MFT-Anwendung ausgeführt wird, bevor die Datenbank erkannt wurde, muss die Verknüpfung manuell erstellt werden. Weitere Informationen finden Sie unter "Anwendungstopologie aktualisieren".

Die Überwachung einer Managed File Transfer-Anwendung erfordert bestimmte Berechtigungen für den Zugriff auf das MFT-Schema. Stackmonitoring unterstützt die Verwendung des MFT-Schemaeigentümers, in der Regel DEV_MFT, als Datenbankzugangsdaten beim Erkennen von MFT. Es wird bevorzugt, einen Überwachungsbenutzer mit nur den Berechtigungen zu erstellen, die zum Überwachen einer MFT-Anwendung erforderlich sind. Sie können denselben Datenbankbenutzer verwenden, um sowohl die Oracle-Datenbank mit dem MFT-Schema als auch die MFT-Anwendung zu überwachen. Schritte zum Erstellen eines Datenbanküberwachungsbenutzers finden Sie im MOS-Hinweis: 2857604.1.

Die spezifischen Berechtigungen werden im folgenden Code definiert. Es wird der MFT-Schemaname DEV_MFT vorausgesetzt. Wenn der Schemaname in Ihrem Setup nicht identisch ist, ersetzen Sie DEV_MFT durch den tatsächlichen Schemanamen im folgenden Code. Ersetzen Sie <user> durch den Datenbanküberwachungsbenutzer, der mit dem Skript erstellt wurde. Stellen Sie sicher, dass die Berechtigungen auf den Überwachungsbenutzer angewendet werden, der in dem Schema DEV_MFT erstellt wurde.

Datenbankberechtigungen:

GRANT SELECT ON DEV_MFT.MV_MFT_SOURCE_MESSAGE TO <your_monitoring_user>;
GRANT SELECT ON DEV_MFT.MV_MFT_TARGET_INFO TO <your_monitoring_user>;
GRANT SELECT ON DEV_MFT.MV_MFT_TRANSFER_COUNT_INFO TO <your_monitoring_user>;
GRANT SELECT ON DEV_MFT.MV_MFT_SOURCE_INFO TO <your_monitoring_user>;
GRANT SELECT ON DEV_MFT.MV_MFT_TRANSFER TO <your_monitoring_user>;

Discovery-Eingabe

Zusammengefasstes OHS

Collocated OHS Discovery ist Teil der Weblogic-Domain-Discovery, und alle zugehörigen Voraussetzungen gelten.

Weitere Informationen zur Installation von OHS mit Colocation finden Sie im Abschnitt Informationen zur Oracle HTTP Server-Installation.

Eigenständiges OHS

Unterstützte Versionen:

• Version 11.x - nur lokales Monitoring, Linux-Host, OPMN-Tool für die Metriksammlung.

• Version 12.x - nur lokales Monitoring, Linux-Host, WLST-Tool für die Metriksammlung

Voraussetzungen:

• Der Management Agent muss auf demselben Host wie der eigenständige Oracle HTTP Server installiert sein.

• Die OHS-Konfigurationsdatei (httpd.conf) muss für den Management Agent-Installationsbenutzer zugänglich und lesbar sein (mgmt_agent für Standalone Agent und oracle-cloud-agent für Oracle Cloud Agent).

OHS-Version 11.x:

Version 11.x OHS erfasst Metriken mit dem OPMN-Tool.

OHS-Version 12.x:

1. Leseberechtigungen für den Agent-Benutzer in der Datei httpd.conf unter:

   <PATH>/user_projects/domains/<domain_name>/config/fmwconfig/components/OHS/<COMP_NAME>/httpd.conf

   Beispiel:

   <PATH>/user_projects/domains/ohs_domain/config/fmwconfig/components/OHS/ohs1

   Führen Sie den folgenden Befehl aus, um Lesezugriff zu erteilen:

   sudo chmod 640 <PATH>/user_projects/domains/<domain_name>/config/fmwconfig/components/OHS/<COMP_NAME>/httpd.conf

2. Leseberechtigungen für den Agent-Benutzer in der OHS-Java-Keystore-Datei unter:

   <ORACLE HOME DIRECTORY>/wlserver/server/lib/DemoTrust.jks (Benutzerdefinierte jks-Datei, falls benutzerdefinierte Zertifikate verwendet werden)

   Beispiel:

   sudo chmod 640 <absolute path to <Oracle Home directory>/wlserver/server/lib/DemoTrust.jks

3. Lese- und Ausführungsberechtigungen auf <ORACLE HOME DIRECTORY>/oracle_common/common/bin/wlst.sh

OHS-Version 11.x-Discovery-Eingang

OHS-Version 12.x-Discovery-Eingang

Voraussetzungen

• Der Management Agent muss auf demselben Host wie Apache HTTP Server installiert sein.
• Aktivieren Sie das Apache-Modul mod_status (https://httpd.apache.org/docs/2.4/mod/mod_status.html). Konfigurieren Sie die /server-status-Speicherortanweisung für den angegebenen Hostnamen und Port.

  Beispiel:

  http(s)://<hostname>:<port>/server-status

• Aktivieren Sie die Anweisung ExtendedStatus (ExtendedStatus) (https://httpd.apache.org/docs/2.4/mod/core.html#extendedstatus).
• Geben Sie gegebenenfalls Zugriffskontrolle für die konfigurierte /server-status-Speicherortanweisung an, damit HTTP/HTTPS-Anforderungen erfolgreich von dem Host ausgeführt werden können, auf dem der Agent installiert ist. Der Agent unterstützt die Basisauthentifizierung nur bei Bedarf mit einer HTTPS-Verbindung. Weitere Informationen zum Konfigurieren der zusätzlichen Zugriffskontrolle finden Sie in der Apache-Dokumentation, -Authentifizierung und -Autorisierung.

• Der Management Agent-Installationsbenutzer muss auf die Apache-Binärdateien zugreifen und diese ausführen können:

  • Die Apache-Datei(en) *.conf, einschließlich der Datei httpd.conf, muss für den Management Agent-Installationsbenutzer zugänglich und lesbar sein (mgmt_agent für Standalone Agent und oracle-cloud-agent für Oracle Cloud Agent).
  • Der Management Agent-Installationsbenutzer muss auf die Apache-Binärdatei (httpd) zugreifen und diese ausführen können (mgmt_agent für Standalone Agent und oracle-cloud-agent für Oracle Cloud Agent).
  • Die Apache-Datei pid (httpd.pid) muss für den Management Agent-Installationsbenutzer zugänglich und lesbar sein (mgmt_agent für Standalone Agent und oracle-cloud-agent für Oracle Cloud Agent).

Im Folgenden finden Sie ein Beispiel dafür, wie Sie alle erforderlichen Berechtigungen für den Management Agent-Benutzer hinzufügen, indem Sie eine dedizierte Apache-Administratorbenutzergruppe erstellen und den Management Agent-Benutzer hinzufügen:

#Create a user group for apache administration
groupadd apache_admin_grp
 
#Add management agent user to the apache admin group
#for user installed management agent
usermod -G apache_admin_grp mgmt_agent
#for oracle cloud agent plugin
usermod -G apache_admin_grp oracle-cloud-agent
 
#Change ownership for apache server root directory and binary file. Example:
chown -R root:apache_admin_grp /etc/httpd
chmod -R 770 /etc/httpd
 
chown -R root:apache_admin_grp /usr/sbin/httpd
chmod -R 770 /usr/sbin/httpd
 
#Grant access to httpd.pid file. Example:
chown -R root:apache_admin_grp /run/httpd
 
#Restart the Agent for the user group assignment to take effect.
#for user installed management agent
systemctl restart mgmt_agent
#for oracle cloud agent plugin
systemctl restart oracle-cloud-agent

Apache HTTP Server-Discovery-Eingabe

Exporteur einrichten

Der Exporteur erfasst Metriken aus OUD und erstellt einen Endpunkt, um die Metriken im Prometheus-Format bereitzustellen. Diese Metriken werden dann vom Management-Agent in den Telemetriedatenspeicher in <specified name space> hochgeladen.

Der Exporteur muss für jede Instanz jedes Installationsmodus eingerichtet werden. Beispiel: Wenn 3 Verzeichnisse und 2 Proxys vorhanden sind, muss der Exporteur 5 Mal eingerichtet werden.

Einrichtungsschritte – Überblick:

1. Stellen Sie sicher, dass Python installiert ist, und installieren Sie auch python-ldap
2. Laufzeitgruppe des OUD-Benutzers zum Benutzer mgmt_agent hinzufügen
3. Exportskript an einen benutzerdefinierten Speicherort kopieren
4. Temporäre Kennwortdateien für den OUD-Exporteur erstellen
5. Monitoringbenutzer für die OUD-Instanz erstellen
6. Erteilen Sie der OUD-Datenbank Dateisystemberechtigungen, um die Datenbankgrößen zu überwachen
7. OUD-Exporteur einrichten
8. OUD-Exporteur nach Neustart des Betriebssystems starten
9. Bestätigen, dass Metriken fließen

Setupschritte:

1. Stellen Sie sicher, dass Python installiert ist, und installieren Sie auch python-ldap:

   • Auf RedHat/Oracle Linux 8 und 9:

     sudo -n yum install -y libnsl python3-ldap httpd-tools

   • Auf RedHat/Oracle Linux 7:

     sudo -n yum install -y libnsl python-ldap httpd-tools

2. Stellen Sie sicher, dass mgmt_agent über die richtigen Berechtigungen verfügt:

   1. Fügen Sie die Laufzeitgruppe des OUD-Benutzers zum Benutzer mgmt_agent hinzu:

      sudo usermod -G <OUD_USER_GROUP> mgmt_agent

   2. Stellen Sie sicher, dass das Verzeichnis <ORACLE_HOME> und die übergeordneten Verzeichnisse Ausführungsberechtigungen haben:

      sudo chmod -R 0750 <ORACLE_HOME_PATH>

3. Kopieren Sie das Exporteurskript an einen benutzerdefinierten Speicherort:

   1. Erstellen Sie ein benutzerdefiniertes Verzeichnis, aus dem der OUD-Exporteur ausgeführt wird.
   2. Ändern Sie den Eigentümer des neuen Verzeichnisses, und erteilen Sie dem Benutzer mgmt_agent Lese- und Ausführungszugriff auf dieses neue Verzeichnis und den gesamten darin enthaltenen Inhalt:

      sudo chown -R mgmt_agent:mgmt_agent <CUSTOM_EXPORTER_DIRECTORY_PATH>

      Beispiel:

      sudo chown -R mgmt_agent:mgmt_agent /scratch/exporter/oud_exporter

   3. Kopieren Sie als Management Agent-Benutzer das Skript manage_exporter.sh aus $AGENT_INST/config/destinations/OCI/services/appmgmt/<Latest_Version>/scripts/oud in das benutzerdefinierte Verzeichnis.

4. Erstellen Sie temporäre Kennwortdateien für den OUD-Exporteur:

   1. Für den Root-Verzeichnisbenutzer, z.B. cn=Directory Manager:

      echo <PASSWORD> | sudo -u mgmt_agent tee
            <FULL_PATH_OF_THE_DIRECTORY_MANAGER_USER_PASSWORD_FILE>/.pw

      Beispiel:

      echo <password> | sudo -u mgmt_agent tee /scratch/exporter/oud_exporter/.pw

   2. Für den Überwachungsbenutzer:

      echo <PASSWORD> | sudo -u mgmt_agent tee <FULL_PATH_OF_THE_MONITORING_USER_PASSWORD_FILE>/.mpw

      Beispiel:

      echo <password> | sudo -u mgmt_agent tee /scratch/exporter/oud_exporter/.mpw

5. Erstellen Sie einen Überwachungsbenutzer für die OUD-Instanz:

   1. Führen Sie als Benutzer mgmt_agent Folgendes aus:

      ./manage_exporter.sh adduser --port <ADMINISTRATION_PORT_OF_THE_OUD_INSTANCE> --utype admin --dstype oud -j <FULL_PATH_OF_THE_DIRECTORY_MANAGER_USER_PASSWORD_FILE> --mpw <FULL_PATH_OF_THE_MONITORING_USER_PASSWORD_FILE> --javaHome <JAVA_HOME_PATH>

      Beispiel:

      ./manage_exporter.sh adduser --port 4444 --utype admin --dstype oud -j /scratch/exporter/oud_exporter/.pw --mpw /scratch/exporter/oud_exporter/.mpw --javaHome /scratch/install/jdk1.8.0_381/

   2. Standardmäßig lautet der Name des Überwachungsbenutzers muser. Er kann mit --muser <name> geändert werden

6. Erteilen Sie der OUD-Datenbank Dateisystemberechtigungen, um die Datenbankgrößen zu überwachen:

   1. sudo getfacl "<OUD_HOME_DIRECTORY_PATH>/OUD/db"

      Beispiel:

      sudo getfacl "/scratch/oud12c/oud_instance/OUD/db"

   2. sudo setfacl -R -m "u:mgmt_agent:rx" "<OUD_HOME_DIRECTORY_PATH>/OUD/db"

      Beispiel:

      sudo setfacl -R -m "u:mgmt_agent:rx" "/scratch/oud12c/oud_instance/OUD/db"

7. OUD-Exporteur einrichten:

   1. Führen Sie als Benutzer mgmt_agent den Setupbefehl aus:

      ./manage_exporter.sh setup --type <PRODUCT_TYPE> --compartment <COMPARTMENT_ID> --name <RESOURCE_NAME> --instName <RESOURCE_NAME> --ldap <LDAP_PORT> --ldaps <LDAPS_PORT> --oracleHome <ORACLE_HOME_PATH> --adminPort <ADMINISTRATION_PORT_OF_THE_OUD_INSTANCE> --metricPort <METRICS_MONITORING_ENDPOINT_PORT> --javaHome <JAVA_HOME_PATH> -D <NAME_OF_THE_MONITORING USER> -j <FULL_PATH_OF_THE_DIRECTORY_MANAGER_USER_PASSWORD_FILE> 

      Beispiel:

      ./manage_exporter.sh setup --type oud --compartment ocid.compartment1.abcdef1234 --name oud_one --instName oud_one --ldap 0 --ldaps 0 --oracleHome /scratch/oud12c --adminPort 4444 --metricPort 1888 --javaHome /scratch/install/jdk1.8.0_381/ -D muser -j /scratch/exporter/oud_exporter/.pw

   2. Starten Sie den Management Agent neu:

      sudo systemctl restart mgmt_agent

   3. Für weitere Optionen während des Setups führen Sie den Hilfebefehl aus:

      ./manage_exporter.sh help

   OUD-Metriken werden im Prometheus-Format am Promethus-Endpunkt erfasst, und der Management-Agent lädt die Metriken auch in die Telemetrie hoch.

8. Aktivieren Sie den Start des OUD-Exporteurs nach einem Neustart des Betriebssystems. Dadurch kann der Benutzer mgmt_agent auch den Management Agent und die Exporter-Services neu starten:

   sudo ./manage_exporter.sh enable

9. Prüfen Sie, ob Metriken fließen:

   1. Um sicherzustellen, dass der Exporteur OUD-Metriken ordnungsgemäß erfasst, rufen Sie den Metrikendpunkt auf dem Host auf, auf dem der Exporteur ausgeführt wird. Es müssen mindestens 40 Metriken vorhanden sein:

      1. In einem Browser müssen https://localhost:<METRICS_MONITORING_ENDPOINT_PORT>/metrics - node_exporter-Zugangsdaten angegeben werden.

         Beispiel:

         https://localhost:1888/metrics

      2. Auf Terminal:

         curl -u "<NODE_EXPORTER_USER>:<NODE_EXPORTER_PASSWORD>" -sk https://127.0.0.1:1888/metrics

   2. Um sicherzustellen, dass der Management Agent nach 5 Minuten seit dem Start des Exporteurs Metriken in die Telemetrie hochlädt, öffnen Sie den Metrik-Explorer in OCI. Wählen Sie das Compartment, den Metrik-Namespace oracle_appmgmt und eine der OUD-Ressourcengruppen aus. Wählen Sie eine beliebige Metrik aus, und prüfen Sie, ob sie korrekt gemeldet wird.

Setup-Befehlsoptionen für Exporteur:

OUD-Status

OUD unterstützt je nach mehreren Faktoren 4 verschiedene Statusarten, die im Folgenden beschrieben werden:

• Aktiviert

  OUD ist hochgefahren, wenn alle Systeme und Metriken normal fließen.

• Unten

  OUD ist heruntergefahren, wenn BindDN fehlt. Es liegt ein Verbindungsproblem mit dem LDAP-Server vor, oder der LDAP-Server ist heruntergefahren.

• Wartung

  Benutzer können OUD jederzeit unter Wartung stellen, um die Instanzen oder andere Zwecke zu warten.

• Warnung

  Die OUD-Instanz hat mindestens einen Servicetest nicht bestanden und sollte daher untersucht werden.

OUD-Status verwalten

So konfigurieren Sie eine OUD-Instanz für "Wartung" oder "Hochgefahren":

./manage_exporter.sh modstate <STATUS>  --port <ADMINISTRATION_PORT_OF_THE_OUD_INSTANCE> --dstype oud -j <FULL_PATH_OF_THE_DIRECTORY_MANAGER_USER_PASSWORD_FILE>

Führen Sie den folgenden Befehl aus, um den aktuellen Status von OUD anzuzeigen:

./manage_exporter.sh showstate --port <ADMINISTRATION_PORT_OF_THE_OUD_INSTANCE> --dstype oud -j <FULL_PATH_OF_THE_DIRECTORY_MANAGER_USER_PASSWORD_FILE>

OUD importieren

OUD kann unabhängig als einer der folgenden Ressourcentypen importiert und überwacht werden:

• OUD Directory-Server
• OUD- Proxy-Server
• OUD-Replication Gateway

Importieren Sie OUD-Ressourcentypen mit dem folgenden Befehl:

oci stack-monitoring resource-task import-telemetry-resources --compartment-id <compartment id> --namespace oracle_appmgmt --source OCI_TELEMETRY_PROMETHEUS --resource-group <resource group>

Importieren Sie jeden Ressourcentyp, nicht jede Instanz. Beispiel: Wenn 3 Verzeichnisse und 2 Proxys vorhanden sind, führen Sie den Importbefehl 2 Mal aus, einmal für jeden Typ.

Nachdem die Ressourcen importiert wurden und eine neue OUD-Instanz hinzugefügt wurde, führen Sie den Importbefehl für den neu hinzugefügten Ressourcentyp erneut aus.

Voraussetzungen

Der Management Agent, der die GoldenGate-Instanz überwacht, muss auf die Oracle GoldenGate-REST-APIs zugreifen können.

Nur das https-Protokoll wird unterstützt. Daher muss die GoldenGate-Instanz mit den erforderlichen Zertifikaten konfiguriert werden.

Management Agent muss Zugriff auf die Truststore-JKS-Datei haben, die das Zertifikat enthält, um die TLS-Verbindung zu validieren.

GoldenGate Discovery-Eingabe

Voraussetzungen

Das Management Agent-Überwachungs-IIS muss lokal auf dem Host bereitgestellt werden, auf dem IIS ausgeführt wird, und die erforderlichen Voraussetzungen sind erfüllt. Weitere Informationen finden Sie unter Voraussetzungen für das Deployment von Management-Agents ausführen.

Microsoft IIS und Local Agent werden während der Discovery ausgeführt.

Microsoft IIS-Discovery-Eingabe

Voraussetzungen

• JMX-Überwachung muss aktiviert sein. Informationen zum Aktivieren der JMX-Überwachung finden Sie unter JMX-Remote aktivieren.

Oracle JVM Runtime Discovery-Eingabe

NGINX Discovery-Eingabe