Oracle Management Agent per Enterprise Manager Cloud Control - Amazon Relational Database Service
RequisitiPrerequisiti dell'hostLimitazioniImpostazioni opzioniAggiunta dell'opzioneFase 2: Sblocco dell'account utente DBSNMPPassaggio 3: aggiunta degli obiettivi alla console di Management AgentEsecuzione delle attività di database con Management AgentRimozione dell'opzione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Oracle Management Agent per Enterprise Manager Cloud Control

Oracle Enterprise Manager (OEM) Management Agent è un componente software che monitora gli obiettivi in esecuzione sugli host e comunica tali informazioni all'Oracle Management Service () di livello intermedio. OMS Amazon RDS supporta Management Agent tramite l'uso dell'OEM_AGENTopzione.

Per ulteriori informazioni, consulta Overview of Oracle Enterprise Manager Cloud Control 12c e Overview of Oracle Enterprise Manager Cloud Control 13c nella documentazione Oracle.

Requisiti per Management Agent

Di seguito sono riportati i requisiti generali per l'utilizzo di Management Agent:

  • L'istanza DB deve eseguire Oracle Database 19c (19.0.0.0). È possibile utilizzare l'architettura CDB o non. CDB

  • È necessario utilizzare un Oracle Management Service (OMS) configurato per connettersi all'istanza DB. Tieni presente i seguenti OMS requisiti:

    • La versione 13.5.0.0.v2 di Management Agent richiede la versione 13.5.0.23. OMS

    • La versione 13.5.0.0.v1 di Management Agent richiede la versione 13.5.0.0. OMS

    • La versione 13.4.0.9.v1 di Management Agent richiede la versione 13.4.0.9 o successiva e la patch 32198287. OMS

  • Nella maggior parte dei casi, è necessario configurare per consentire le connessioni dall'istanza DBVPC. OMS Se non conosci Amazon Virtual Private Cloud (AmazonVPC), ti consigliamo di completare i passaggi indicati Tutorial: Creazione di un Amazon VPC da utilizzare con un'istanza database (solo IPv4) prima di continuare.

  • Puoi utilizzare Management Agent con Oracle Enterprise Manager Cloud Control per 12c e 13c. Assicurati di disporre di spazio di archiviazione sufficiente per la OEM versione:

    • Almeno 8,5 GiB OEM per 13c Release 5

    • Almeno 8,5 GiB OEM per 13c Release 4

    • Almeno 8,5 GiB OEM per 13c Release 3

    • Almeno 5,5 GiB OEM per 13c Release 2

    • Almeno 4,5 GiB OEM 13c Release 1

    • Almeno 2,5 GiB per 12c OEM

  • Se utilizzi versioni di Management Agent OEM_AGENT 13.2.0.0.v3 e desideri utilizzare la TCPS connettività13.3.0.0.v2, segui le istruzioni in Configurazione dei certificati CA di terze parti per la comunicazione con i database di destinazione nella documentazione Oracle. Inoltre, aggiorna il tuo JDK account OMS seguendo le istruzioni contenute nel documento Oracle con l'ID Oracle Doc 2241358.1. Questo passaggio garantisce il supporto di tutte le suite di crittografia OMS supportate dal database.

    Nota

    TCPSla connettività tra Management Agent e l'istanza DB è supportata per Management AgentOEM_AGENT 13.2.0.0.v3, 13.3.0.0.v213.4.0.9.v1, e versioni successive.

OMSprerequisiti per la comunicazione dell'host

Assicurati che l'OMShost e l'istanza Amazon RDS DB possano comunicare. Esegui questa operazione:

  • Per connetterti dal Management Agent alla tuaOMS, se la tua OMS è protetta da un firewall, aggiungi gli indirizzi IP delle tue istanze DB alla tuaOMS.

    Assicurati che il firewall OMS consenta il traffico sia dalla porta del listener DB (impostazione predefinita 1521) che dalla porta dell'OEMagente (impostazione predefinita 3872), proveniente dall'indirizzo IP dell'istanza DB.

  • Per connetterti dal tuo OMS al Management Agent, se hai un nome host risolvibile pubblicamente, aggiungi l'OMSindirizzo a un gruppo di sicurezza. OMS Il gruppo di sicurezza deve avere regole in entrata che permettono l'accesso alla porta del listener di database e a quella del Management Agent. Per un esempio su come creare un gruppo di sicurezza e aggiungere regole in entrata, consulta Tutorial: Creazione di un Amazon VPC da utilizzare con un'istanza database (solo IPv4).

  • Per connetterti dal tuo OMS al Management Agent, se OMS non disponi di un nome host risolvibile pubblicamente, usa uno dei seguenti:

Limitazioni per Management Agent

Di seguito sono riportate alcune delle limitazioni all’utilizzo di Management Agent:

  • Non è possibile fornire immagini personalizzate di Oracle Management Agent.

  • Le attività amministrative come l'esecuzione dei processi e l'applicazione di patch ai database, che richiedono credenziali host, non sono supportate.

  • Non è garantito che i parametri host e l'elenco di processi riflettano lo stato reale del sistema. Pertanto, non è consigliabile utilizzarle OEM per monitorare il file system root o il file system mount point. Per ulteriori informazioni sul monitoraggio del sistema operativo, vedere Monitoraggio dei parametri del sistema operativo con il monitoraggio avanzato.

  • L'individuazione automatica non è supportata. È necessario aggiungere manualmente le destinazioni dei database.

  • OMSla disponibilità del modulo dipende dall'edizione del database. Ad esempio, la diagnosi delle prestazioni del database e il modulo di ottimizzazione sono disponibili solo per Oracle Database Enterprise Edition.

  • Management Agent consuma memoria e risorse di calcolo ulteriori. Se hai problemi di prestazioni dopo aver abilitato l'opzione OEM_AGENT, ti consigliamo di aumentare a una classe di istanza database più ampia. Per ulteriori informazioni, consulta Classi di istanze DB e Modifica di un'istanza Amazon RDS DB.

  • L'utente che esegue l'OEM_AGENTRDShost Amazon non ha accesso al registro degli avvisi dal sistema operativo. Pertanto, non è possibile raccogliere metriche per DB Alert Log e DB Alert Log Error Status in OEM entrata.

Impostazioni dell'opzione per Management Agent

Amazon RDS supporta le seguenti impostazioni per l'opzione Management Agent.

Impostazione opzioni Campo obbligatorio Valori validi Descrizione

Version (AGENT_VERSION)

Sì

13.5.0.0.v2

13.5.0.0.v1

13.4.0.9.v1

13.3.0.0.v2

13.3.0.0.v1

13.2.0.0.v3

13.2.0.0.v2

13.2.0.0.v1

13.1.0.0.v1

La versione del software Management Agent. La versione minima supportata è13.1.0.0.v1.

Il nome dell' AWS CLI opzione èOptionVersion.

Nota

Nelle AWS GovCloud (US) regioni, le versioni 13.1 non sono disponibili.

Porta (AGENT_PORT)

Sì

Un valore intero.

La porta sull'istanza DB che ascolta l'OMShost. Il valore predefinito è 3872. L'OMShost deve appartenere a un gruppo di sicurezza che ha accesso a questa porta.

Il nome dell' AWS CLI opzione èPort.

Gruppi di sicurezza

Sì

Gruppi di sicurezza esistenti

Un gruppo di sicurezza che ha accesso a Port (Porta). L'OMShost deve appartenere a questo gruppo di sicurezza.

Il nome dell' AWS CLI opzione è VpcSecurityGroupMemberships oDBSecurityGroupMemberships.

OMS_HOST

Sì

Un valore di stringa, ad esempio my.example.oms

Il nome host o l'indirizzo IP accessibili pubblicamente diOMS.

Il nome dell' AWS CLI opzione èOMS_HOST.

OMS_PORT

Sì

Un valore intero.

La porta di HTTPS caricamento sull'OMShost che ascolta il Management Agent.

Per determinare la porta di HTTPS caricamento, connettiti all'OMShost ed esegui il comando seguente (che richiede la SYSMAN password):

emctl status oms -details

Il nome dell' AWS CLI opzione èOMS_PORT.

AGENT_REGISTRATION_PASSWORD

Sì

Un valore di stringa.

La password utilizzata dal Management Agent per autenticarsi con. OMS Si consiglia di creare una password permanente OMS prima di abilitare l'OEM_AGENTopzione. Con una password persistente puoi condividere un singolo gruppo di opzioni di Management Agent tra più RDS database Amazon.

Il nome dell' AWS CLI opzione èAGENT_REGISTRATION_PASSWORD.

ALLOW_TLS_ONLY

No

true, false (default)

Un valore che configura l'OEMagente in modo che supporti solo il TLSv1 protocollo mentre l'agente è in ascolto come server. Questa impostazione non è più supportata. Le versioni 13.1.0.0.v1 e successive di Management Agent supportano Transport Layer Security () per impostazione predefinita. TLS

MINIMUM_TLS_VERSION

No

TLSv1 (default), TLSv1.2

Un valore che specifica la TLS versione minima supportata dall'OEMagente mentre l'agente è in ascolto come server. Le versioni dell'agente non supportate supportano solo l'impostazione. TLSv1

TLS_CIPHER_SUITE

No

Per informazioni, consulta Impostazioni dell'opzione per Management Agent.

Un valore che specifica la suite di TLS crittografia utilizzata dall'OEMagente mentre l'agente è in ascolto come server.

La tabella seguente elenca le suite di TLS crittografia supportate dall'opzione Management Agent.

Suite di cifratura Versione Agent supportata Conforme alla normativa Fed RAMP
TLS_ _ _ RSA _128_ WITH _ AES CBC SHA Tutti No
TLS_ _ _ RSA _128_ WITH _ AES CBC SHA256 13.1.0.0.v1 e versioni successive No
TLS_ _ _ _256_ _ RSA WITH AES CBC SHA 13.2.0.0.v3 e versioni successive No
TLS_ _ _ _256_ _ RSA WITH AES CBC SHA256 13.2.0.0.v3 e versioni successive No
TLS_ _ _ _ _128_ _ ECDHE RSA WITH AES CBC SHA 13.2.0.0.v3 e versioni successive Sì
TLS_ _ _ _ _256_ _ ECDHE RSA WITH AES CBC SHA 13.2.0.0.v3 e versioni successive Sì
TLS_ _ _ _ _128_ _ ECDHE RSA WITH AES CBC SHA256 13.2.0.0.v3 e versioni successive Sì
TLS_ _ _ _ _256_ _ ECDHE RSA WITH AES CBC SHA384 13.2.0.0.v3 e versioni successive Sì

Passaggio 1: aggiunta dell'opzione Management Agent all'istanza DB

Per aggiungere l'opzione Management Agent all'istanza DB, procedi come segue:

  1. Creare un nuovo gruppo di opzioni oppure copiare o modificare un gruppo di opzioni esistente.

  2. Aggiungere l'opzione al gruppo di opzioni.

  3. Associare il gruppo di opzioni a questa istanza database.

Se riscontri errori, puoi consultare i documenti di My Oracle Support per informazioni sulla risoluzione di problemi specifici.

Dopo aver aggiunto l'opzione Management Agent, non è necessario riavviare l'istanza database. Non appena il gruppo di opzioni è attivo, l'OEMagente è attivo.

Se il tuo OMS host utilizza un certificato di terze parti non attendibile, Amazon RDS restituisce il seguente errore.

You successfully installed the OEM_AGENT option. Your OMS host is using an untrusted third party certificate. 
Configure your OMS host with the trusted certificates from your third party.

Se viene restituito questo errore, l'opzione Management Agent non è abilitata finché il problema non viene corretto. Per informazioni sulla correzione del problema, consulta il documento di supporto My Oracle 2202569.1.

Per aggiungere l'opzione Management Agent alla tua istanza DB

  1. Determinare il gruppo di opzioni che si desidera usare. È possibile creare un nuovo gruppo di opzioni oppure usare un gruppo di opzioni esistente. Se si desidera usare un gruppo di opzioni esistente, puoi passare alla fase successiva. In caso contrario, creare un gruppo di opzioni database personalizzato con le seguenti impostazioni:

    1. Per Engine (Motore) scegliere l'edizione Oracle per l'istanza database.

    2. In Major engine version (Versione principale del motore), scegliere la versione dell'istanza database.

    Per ulteriori informazioni, consulta Creazione di un gruppo di opzioni.

  2. Aggiungi l'AGENTopzione OEM_ al gruppo di opzioni e configura le impostazioni delle opzioni. Per ulteriori informazioni sull'aggiunta di opzioni, consulta Aggiunta di un'opzione a un gruppo di opzioni. Per ulteriori informazioni su ciascuna impostazione, consulta Impostazioni dell'opzione per Management Agent.

  3. Applicare il gruppo di opzioni a un'istanza database nuova o esistente:

    • Per una nuova istanza database, si applica il gruppo di opzioni quando viene avviata l'istanza. Per ulteriori informazioni, consulta Creazione di un'istanza Amazon RDS DB.

    • Per un'istanza database esistente, viene applicato il gruppo di opzioni modificando l'istanza e collegando il nuovo gruppo di opzioni. Per ulteriori informazioni, consulta Modifica di un'istanza Amazon RDS DB.

L'esempio seguente utilizza il comando AWS CLI add-option-to-option-group per aggiungere l'OEM_AGENTopzione a un gruppo di opzioni chiamatomyoptiongroup.

In Linux, macOS, oppure Unix:

aws rds add-option-to-option-group \
    --option-group-name "myoptiongroup" \
    --options OptionName=OEM_AGENT,OptionVersion=13.1.0.0.v1,Port=3872,VpcSecurityGroupMemberships=sg-1234567890,OptionSettings=[{Name=OMS_HOST,Value=my.example.oms},{Name=OMS_PORT,Value=4903},{Name=AGENT_REGISTRATION_PASSWORD,Value=password}] \
    --apply-immediately

In Windows:

aws rds add-option-to-option-group ^
    --option-group-name "myoptiongroup" ^
    --options OptionName=OEM_AGENT,OptionVersion=13.1.0.0.v1,Port=3872,VpcSecurityGroupMemberships=sg-1234567890,OptionSettings=[{Name=OMS_HOST,Value=my.example.oms},{Name=OMS_PORT,Value=4903},{Name=AGENT_REGISTRATION_PASSWORD,Value=password}] ^
    --apply-immediately

Fase 2: Sblocco dell'account utente DBSNMP

Il Management Agent utilizza l'account DBSNMP utente per connettersi al database e segnalare i problemi a Oracle Enterprise Manager. In aCDB, DBSNMP è un utente comune. Questo account utente è necessario sia per Management Agent che per OEM Database Express. Per impostazione predefinita, questo account è bloccato. La procedura per sbloccare questo account varia a seconda che il database utilizzi l'architettura non- CDB o. CDB

Per sbloccare l'account utente DBSNMP

  1. In SQL *Plus o in un'altra SQL applicazione Oracle, accedi alla tua istanza DB come utente principale.

  2. Esegui una delle seguenti azioni, a seconda dell'architettura del database:

    Il tuo database non è unCDB.

    Esegui la seguente SQL dichiarazione:

    ALTER USER dbsnmp IDENTIFIED BY new_password ACCOUNT UNLOCK;
    Il tuo database è unCDB.

    Esegui la seguente procedura memorizzata per sbloccare l'DBSNMPaccount:

    EXEC rdsadmin.rdsadmin_util.reset_oem_agent_password('new_password');

    Se ricevi un errore che indica che la procedura non esiste, riavvia l'CDBistanza per installarla automaticamente. Per ulteriori informazioni, consulta Riavvio di un'istanza database.

Passaggio 3: aggiunta degli obiettivi alla console di Management Agent

Per aggiungere un'istanza DB come destinazione, assicurati di conoscere l'endpoint e la porta. Per informazioni su come trovare l'endpoint per la tua istanza Amazon RDS DB, consultaEsito dell'endpoint dell'istanza database RDS per Oracle. Se il database utilizza l'CDBarchitettura, aggiungi il CDB$ROOT contenitore separatamente come destinazione.

Per aggiungere destinazioni alla console del Management Agent

  1. Nella OMS console, scegli Configurazione, Aggiungi destinazione, Aggiungi obiettivi manualmente.

  2. Scegliere Add Targets Declaratively by Specifying Target Monitoring Properties (Aggiungi destinazioni in modo dichiarativo specificando le proprietà di monitoraggio della destinazione).

  3. Per Target Type (Tipo di destinazione), scegliere Database Instance (Istanza database).

  4. Per Monitoring Agent, scegli l'agente con l'identificatore uguale all'identificatore dell'istanza RDS DB.

  5. Scegliere Add Manually (Aggiungi manualmente).

  6. Inserisci l'endpoint per la tua istanza Amazon RDS DB o selezionalo dall'elenco dei nomi host. Assicurati che il nome host specificato corrisponda all'endpoint dell'istanza Amazon RDS DB.

  7. Specificare le seguenti proprietà del database:

    • Immettere un nome in Target Name (Nome destinazione).

    • Immettere un nome in Database system name (Nome del sistema di database).

    • Immettere dbsnmp in Monitor username (Nome utente monitoraggio).

    • Per Monitor password, inserisci la password daFase 2: Sblocco dell'account utente DBSNMP.

    • In Role (Ruolo) immettere normal (normale).

    • In Oracle home path (Percorso home di Oracle) immettere /oracle.

    • Per Listener Machine name (Nome macchina listener), viene già visualizzato l'identificatore dell'agente.

    • In Port (Porta) immettere la porta del database. La porta RDS predefinita è 1521.

    • In Database name (Nome del database) immettere il nome del database. Se il database è unCDB, questo nome èRDSCDB.

  8. Scegliere Test Connection (Connessione di prova).

  9. Scegli Next (Successivo). Il database di destinazione viene visualizzato nell'elenco di risorse monitorate.

Amministrazione dell'agente di gestione

Puoi utilizzare RDS le procedure Amazon per eseguire determinati EMCTL comandi sul Management Agent. Con queste procedure, puoi eseguire le attività elencate di seguito.

Nota

Le attività vengono eseguite in modo asincrono.

Ottenere lo stato del Management Agent

Per conoscere lo stato del Management Agent, esegui la RDS procedura Amazonrdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent. Questa procedura equivale al comando emctl status agent.

La procedura seguente crea un'attività per ottenere lo stato del Management Agent e restituisce l'ID dell'attività.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent() as TASK_ID from DUAL;

Per visualizzare il risultato visualizzando il file di output dell'attività, consulta Visualizzazione dello stato di un'attività in corso.

Riavvio di Management Agent

Per riavviare il Management Agent, esegui la RDS procedura Amazonrdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent. Questa procedura equivale ai comandi emctl stop agent e emctl start agent.

La procedura seguente crea un'attività per riavviare Management Agent e restituisce l'ID dell'attività.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent as TASK_ID from DUAL;

Per visualizzare il risultato visualizzando il file di output dell'attività, consulta Visualizzazione dello stato di un'attività in corso.

Elenco delle destinazioni monitorate da Management Agent

Per elencare gli obiettivi monitorati dal Management Agent, esegui la RDS procedura Amazonrdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent. Questa procedura equivale al comando emctl config agent listtargets.

La procedura seguente crea un'attività per elencare le destinazioni monitorate dal Management Agent e restituisce l'ID dell'attività.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent as TASK_ID from DUAL;

Per visualizzare il risultato visualizzando il file di output dell'attività, consulta Visualizzazione dello stato di un'attività in corso.

Elenco dei thread di raccolta monitorati da Management Agent

Per elencare tutti i thread di raccolta in esecuzione, pronti e pianificati monitorati dal Management Agent, esegui la RDS procedura rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent Amazon. Questa procedura equivale al comando emctl status agent scheduler.

La procedura seguente crea un'attività per elencare i thread di raccolta e restituisce l'ID dell'attività.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent() as TASK_ID from DUAL;

Per visualizzare il risultato visualizzando il file di output dell'attività, consulta Visualizzazione dello stato di un'attività in corso.

Cancellazione dello stato di Management Agent

Per cancellare lo stato del Management Agent, esegui la RDS procedura Amazonrdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent. Questa procedura equivale al comando emctl clearstate agent.

La procedura seguente crea un'attività che cancella lo stato del Management Agent e restituisce l'ID dell'attività.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent() as TASK_ID from DUAL;

Per visualizzare il risultato visualizzando il file di output dell'attività, consulta Visualizzazione dello stato di un'attività in corso.

Fare in modo che il Management Agent carichi il suo OMS

Per fare in modo che il Management Agent carichi l'Oracle Management Server (OMS) ad esso associato, esegui la RDS procedura Amazonrdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent. Questa procedura equivale al comando emclt upload agent.

La procedura seguente crea un task che fa sì che il Management Agent carichi i dati associati OMS e restituisca l'ID del task.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent() as TASK_ID from DUAL;

Per visualizzare il risultato visualizzando il file di output dell'attività, consulta Visualizzazione dello stato di un'attività in corso.

Eseguire il ping del OMS

Per eseguire il ping del Management AgentOMS, esegui la RDS procedura Amazonrdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent. Questa procedura equivale al comando emctl pingOMS.

La procedura seguente crea un'attività che esegue il ping del Management Agent OMS e restituisce l'ID dell'attività.

SELECT rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent() as TASK_ID from DUAL;

Per visualizzare il risultato visualizzando il file di output dell'attività, consulta Visualizzazione dello stato di un'attività in corso.

Visualizzazione dello stato di un'attività in corso

È possibile visualizzare lo stato di un'attività in corso in un file bdump. I file bdump si trovano nella directory /rdsdbdata/log/trace. Il nome del file bdump ha il formato che segue.

dbtask-task-id.log

Per monitorare un'attività, sostituisci task-id con l'ID di tale attività.

Per visualizzare il contenuto dei file bdump, esegui la RDS procedura rdsadmin.rds_file_util.read_text_file Amazon. La query seguente restituisce i contenuti del file bdump dbtask-1546988886389-2444.log. 

SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-1546988886389-2444.log'));

Per ulteriori informazioni sulla RDS procedura Amazonrdsadmin.rds_file_util.read_text_file, consultaLettura dei file in una directory di istanze database.

Rimozione dell'opzione Management Agent

Puoi rimuovere l'OEMagente da un'istanza DB. Dopo aver rimosso l'OEMagente, non è necessario riavviare l'istanza DB.

Per rimuovere l'OEMagente da un'istanza DB, esegui una delle seguenti operazioni:

  • Rimuovi l'opzione OEM Agent dal gruppo di opzioni a cui appartiene. Questa modifica coinvolge tutte le istanze database che usano il gruppo di opzioni. Per ulteriori informazioni, consulta Rimozione di un'opzione da un gruppo di opzioni.

  • Modificate l'istanza DB e specificate un gruppo di opzioni diverso che non includa l'opzione OEM Agent. Questa modifica coinvolge una singola istanza database. È possibile specificare il gruppo di opzioni predefinito (vuoto) o un gruppo di opzioni personalizzato diverso. Per ulteriori informazioni, consulta Modifica di un'istanza Amazon RDS DB.