Raccogli dati modello entità da Enterprise Manager Cloud Control e raccogli log

Oracle Enterprise Manager Cloud Control (EM) è la soluzione di gestione IT (Enterprise Information Technology) di Oracle che offre una soluzione di gestione cloud aziendale completa, integrata e orientata al business. EM raccoglie informazioni aggiuntive su entità quali le informazioni di configurazione necessarie per individuare i file di log e le relazioni tra entità per fornire viste topologiche delle applicazioni. Queste viste topologiche tra i componenti dello stack dell'applicazione aiutano a risolvere facilmente i problemi relativi alla disponibilità e alle prestazioni dell'applicazione. Gli utenti esistenti di EM possono impostare il bridge EM e trarre vantaggio dall'impostazione automatica che importa i dati del modello entità, ad esempio le associazioni di entità, e le informazioni sulle proprietà da EM in Oracle Log Analytics. Le informazioni sull'associazione delle entità vengono quindi utilizzate per creare la topologia in Oracle Log Analytics.

Ulteriori informazioni sulla raccolta dei dati da EM:

Le destinazioni EM che rappresentano le risorse on premise sono equivalenti alle entità in Oracle Log Analytics. Pertanto, puoi sfruttare le destinazioni trovate in EM per ottenere un onboarding più rapido in Oracle Log Analytics invece di ricrearle.
La topologia in EM, inclusa quella delle destinazioni composte complesse, viene conservata e riprodotta in Oracle Log Analytics. Le associazioni di destinazione in EM vengono convertite in relazioni entità in Oracle Log Analytics evitando la perdita di informazioni.
I metadati di destinazione rilevanti in EM vengono memorizzati come proprietà dell'entità in Oracle Log Analytics per consentire un migliore monitoraggio di tali risorse EM.
Le proprietà dell'entità vengono aggiornate periodicamente con le informazioni di destinazione trasferite da EM allo storage degli oggetti OCI e, a loro volta, raccolte da Oracle Log Analytics utilizzando un bridge EM.
- Subito dopo aver configurato il bridge EM, vengono raccolte le informazioni sulle destinazioni EM e sulle relative associazioni.
- La periodicità della trasmissione delle informazioni da EM e della loro raccolta in Oracle Log Analytics in un secondo momento:
  
  Metriche di configurazione e associazioni di destinazione: Giornaliero
  
  Proprietà target e target: Orario

Panoramica del flusso di lavoro per la raccolta dei dati da EM:

Per poter raccogliere il modello dati entità da EM, è innanzitutto necessario raggruppare le destinazioni in EM per il servizio Oracle Log Analytics. Creare un bridge cloud nell'ambiente monitorato da EM per esportare le informazioni di destinazione nello storage degli oggetti OCI. Dopo aver confermato che i dati dell'entità vengono raccolti nello storage degli oggetti, creare un bridge EM tra lo storage degli oggetti e Oracle Log Analytics per importare le informazioni dell'entità in Oracle Log Analytics. Le entità vengono create automaticamente in Oracle Log Analytics utilizzando le informazioni sulle entità raccolte da EM. Per raccogliere i log dalle destinazioni in EM, associare le entità create automaticamente alle origini di log in modo che i log possano essere raccolti utilizzando i Management Agent.

Di seguito sono riportati i passi di panoramica per raccogliere i dati EM e raccogliere i log.

Creare un bucket di storage degli oggetti OCI per raccogliere i dati di destinazione da EM. Vedere Crea un bucket: Uso della console.
Prima di impostare il bridge EM, è necessario preparare l'ambiente EM per esportare le informazioni richieste in OCI. Vedere Prerequisiti per la creazione del bridge EM.

A questo punto, la connettività OCI viene impostata e i dati di destinazione vengono caricati automaticamente a intervalli frequenti nello storage degli oggetti OCI.
Utilizzando il nome del compartimento e il nome del bucket specificati in EM durante l'impostazione del bridge cloud, verificare nello storage degli oggetti OCI che la raccolta dei dati dell'entità sia riuscita. Vedere Visualizza dettagli bucket: Utilizzo della console in Documentazione di Oracle Cloud Infrastructure.
Installare i Management Agent negli host EM per raccogliere continuamente i log dalle entità EM:

Vedere Documentazione di Oracle Management Agents per completare i task riportati di seguito.
- Eseguire i prerequisiti per la distribuzione dei Management Agent
- Installare i Management Agent
Creare criteri IAM per raccogliere le informazioni sull'entità dallo storage degli oggetti. Vedere Consenti agli utenti di eseguire operazioni bridge EM.
Ora che le informazioni sull'entità sono disponibili nello storage degli oggetti OCI, creare un bridge EM per raccoglierle e creare il modello dati dell'entità che consente di eseguire un'analisi completa del log per il monitoraggio delle destinazioni EM. Dopo aver creato il bridge EM, le entità vengono create automaticamente in Oracle Log Analytics.
- Utilizzo della console: Aggiungi un bridge EM
- Uso dell'interfaccia CLI: Operazioni bridge EM tramite CLI
- Utilizzo dell'API REST: Operazioni bridge EM tramite API REST
Nota
- Operazione Crea bridge EM:
  
  Ogni bridge EM deve avere un nome visualizzato univoco in una tenancy specifica.
  
  In una determinata tenancy può essere presente un solo bridge EM per un bucket dell'area di memorizzazione degli oggetti OCI specifico.
- Operazione Elimina bridge EM:
  
  Se si elimina un bridge EM, le entità create automaticamente utilizzando il bridge EM non verranno eliminate.
  
  Se una destinazione viene eliminata in EM, l'entità corrispondente non viene eliminata automaticamente in Oracle Log Analytics.
- Modifica del compartimento bridge EM:
  
  Questa operazione sposta solo la risorsa bridge EM in un altro compartimento. Le entità create automaticamente quando si crea il bridge EM non possono essere spostate in altri compartimenti.
Assicurarsi di abilitare la funzione di associazione automatica per le origini specifiche che si desidera associare alle entità EM. Vedere Abilitare l'associazione automatica per un'origine. Dopo la creazione del bridge EM, le entità idonee vengono associate automaticamente alle origini pertinenti.

A questo punto, i log inizieranno a raccogliere dalle destinazioni EM in Oracle Log Analytics. È possibile visualizzarli in Log Explorer.

Per interrompere la raccolta dei log dalle destinazioni EM, vedere Arresta raccolta di log basata su agente.

Prerequisiti per la creazione del bridge EM

Prima di creare il bridge EM per raccogliere i dati delle entità dallo storage degli oggetti, è necessario eseguire i task riportati di seguito nell'ambiente EM. Per i passi dettagliati, vedere Integrating Enterprise Manager with OCI Services nel manuale Enterprise Manager Cloud Control Administrator's Guide.

Definire una credenziale denominata globale in Enterprise Manager per OCI.
Impostare un utente esclusivo per il login a Enterprise Manager.
Creare un gruppo Enterprise Manager contenente le destinazioni per le quali si desidera esportare i dati in Oracle Log Analytics.
Definire le credenziali preferenziali dell'host per tutti gli host OMS.
Esportare i dati di Enterprise Manager in OCI creando un bridge cloud. Selezionare Logging Analytics come Servizio OCI che utilizzerà i dati e specificherà il gruppo di destinazione creato in precedenza.
Verificare lo stato di caricamento dei dati per Oracle Log Analytics sul lato EM.

Consenti agli utenti di eseguire operazioni bridge EM

Tipo di risorsa individuale: loganalytics-em-bridge

Parte del tipo di risorsa aggregato: loganalytics-resources-family

Caso d'uso Criteri IAM

Caso d'uso	Criteri IAM
Il bridge EM può trovarsi in qualsiasi compartimento della tenancy	Regola di esempio per creare un gruppo dinamico per le risorse bridge EM: `ALL {resource.type='loganalyticsembridge'}` Istruzione criterio di esempio per fornire le autorizzazioni agli utenti o ai gruppi di utenti per gestire la risorsa bridge EM: `allow group <user_group> to MANAGE loganalytics-em-bridge in tenancy` Istruzione criterio di esempio per consentire al gruppo dinamico delle risorse bridge EM di LEGGERE lo storage degli oggetti: `allow dynamic-group <group_name> to read objects in tenancy`
Il bridge EM può trovarsi in un compartimento specifico	Regola di esempio per creare un gruppo dinamico per le risorse bridge EM: `ALL {resource.type='loganalyticsembridge', resource.compartment.id=<loganalyticsembridge_resource_compartment_OCID>}` Istruzione criterio di esempio per fornire le autorizzazioni agli utenti o ai gruppi di utenti per gestire la risorsa bridge EM: `allow group <user_group> to MANAGE loganalytics-em-bridge in compartment id <compartment_OCID>` Istruzione criterio di esempio per consentire al gruppo dinamico delle risorse bridge EM di LEGGERE lo storage degli oggetti: `allow dynamic-group <group_name> to read objects in compartment <compartment_name>`

Il bridge EM può trovarsi in qualsiasi compartimento della tenancy

Regola di esempio per creare un gruppo dinamico per le risorse bridge EM:

ALL {resource.type='loganalyticsembridge'}
Istruzione criterio di esempio per fornire le autorizzazioni agli utenti o ai gruppi di utenti per gestire la risorsa bridge EM:

allow group <user_group> to MANAGE loganalytics-em-bridge in tenancy
Istruzione criterio di esempio per consentire al gruppo dinamico delle risorse bridge EM di LEGGERE lo storage degli oggetti:

allow dynamic-group <group_name> to read objects in tenancy

Il bridge EM può trovarsi in un compartimento specifico

Regola di esempio per creare un gruppo dinamico per le risorse bridge EM:

ALL {resource.type='loganalyticsembridge', resource.compartment.id=<loganalyticsembridge_resource_compartment_OCID>}
Istruzione criterio di esempio per fornire le autorizzazioni agli utenti o ai gruppi di utenti per gestire la risorsa bridge EM:

allow group <user_group> to MANAGE loganalytics-em-bridge in compartment id <compartment_OCID>
Istruzione criterio di esempio per consentire al gruppo dinamico delle risorse bridge EM di LEGGERE lo storage degli oggetti:

allow dynamic-group <group_name> to read objects in compartment <compartment_name>

Gli esempi precedenti forniscono l'autorizzazione MANAGE per loganalytics-em-bridge nella tenancy o in un compartimento specifico.

Quando si crea un criterio IAM per loganalytics-em-bridge, è possibile eseguire le operazioni riportate di seguito con ciascun verbo.

`Inspect`	`Read`	`Use`	`Manage`
Elenca i ponti EM e il loro riepilogo	Ottenere i dettagli su un bridge EM	Uso ha lo stesso livello di autorizzazioni e operazioni API di Lettura.	Creare, aggiornare o eliminare un bridge EM o spostarlo in un altro compartimento.

Aggiungi un bridge EM

Aprire il menu di navigazione e fare clic su Observability & Management. In Log Analytics, fare clic su Amministrazione.
Le risorse di amministrazione sono elencate nel riquadro di navigazione a sinistra in Amministrazione. Fare clic su EM Bridges. Nella pagina di elenco di bridge EM vengono visualizzati i bridge EM disponibili.
Fare clic su Crea bridge.

Viene visualizzata la finestra di dialogo Crea bridge.
Immettere le informazioni riportate di seguito.
1. Nome bridge: il nome visualizzato del bridge EM.
2. Compartimento bridge EM: compartimento in cui deve essere creata la risorsa bridge EM. Questa opzione viene impostata automaticamente sul compartimento selezionato nella pagina di elenco dei bridge EM.
3. Descrizione (facoltativo): la descrizione del bridge EM.
4. In Configurazione del bridge lato OEM, sezione Compartimento di storage degli oggetti: il compartimento nello storage degli oggetti in cui vengono memorizzati i dati EM
5. In Configurazione del bridge lato OEM, sezione Bucket di storage degli oggetti: il nome del bucket nello storage degli oggetti in cui vengono memorizzati i dati EM
6. Compartimento entità: il compartimento in cui devono essere create le entità
Fare clic su Crea.

Operazioni bridge EM tramite CLI

Prima di iniziare a utilizzare l'interfaccia CLI per eseguire le operazioni bridge EM,

Raccogliere lo spazio di nomi per la tenancy:
- Uso della console: fare clic sul profilo nell'angolo in alto a destra della console OCI, fare clic su Tenancy:<tenancy_name> e prendere nota del valore Spazio di nomi dello storage degli oggetti nella pagina risultante.
- Utilizzo dell'interfaccia CLI: vedere Namespace: list.
Fornire le autorizzazioni appropriate per LIST, GET e USE della risorsa loganalytics-em-bridge. Vedere Raccolta dei dati del modello di entità da Enterprise Manager Cloud Control e raccolta dei log.
Per informazioni sull'uso dell'interfaccia CLI, vedere Command Line Interface (CLI).

Per un elenco completo dei flag e delle opzioni disponibili per i comandi CLI, vedere Riferimento per la riga di comando.

Elenca le operazioni bridge EM disponibili

Vedere em-bridge.

Creare un bridge EM

Per creare un bridge EM, vedere EM-bridge: create. Ad esempio:

oci log-analytics em-bridge create -ns <Namespace> -c <Object_Storage_Compartment_OCID> --display-name <EM_Bridge_Name> --bucket-name <Object_Storage_Bucket_Name> --description "<EM_Bridge_Description>" --em-entities-compartment-id <Entity_Compartment_OCID>

Nell'esempio di comando CLI riportato di seguito.

Spazio di nomi: spazio di nomi della tenancy
Object_Storage_Compartment_OCID: OCID del compartimento nello storage degli oggetti in cui vengono memorizzati i dati EM
EM_Bridge_Name: nome visualizzato del bridge EM
Object_Storage_Bucket_Name: il nome del bucket nello storage degli oggetti in cui vengono memorizzati i dati EM
EM_Bridge_Description: descrizione del bridge EM
Entity_Compartment_OCID: OCID del compartimento in cui devono essere create le entità

Ottenere i dettagli su un bridge EM

Per ottenere i dettagli sul bridge EM, vedere EM-bridge: get.

Comandi di esempio per ottenere ulteriori dettagli sul bridge EM:

oci log-analytics em-bridge get -ns <Namespace> --bridge-id <EM_Bridge_OCID>

oci log-analytics entity get -ns <Namespace> --bridge-id <EM_Bridge_OCID>

Elenco dei bridge EM

Per elencare i bridge EM, vedere EM-bridge: list.

Comando di esempio per elencare i bridge EM:

oci log-analytics em-bridge list -ns <Namespace> -c <EM_Bridge_Compartment_OCID>

Operazioni bridge EM tramite API REST

È possibile eseguire le operazioni bridge EM riportate di seguito utilizzando l'API.

Creare un bridge EM: CreateLogAnalyticsEmBridge
Eliminare un bridge EM: DeleteLogAnalyticsEmBridge
Ottenere i dettagli per un bridge EM: GetLogAnalyticsEmBridge
Ottenere un riepilogo del conteggio bridge EM in un compartimento specifico: GetLogAnalyticsEmBridgeSummary
Ottenere una lista di tutti i bridge EM in un compartimento specifico: ListLogAnalyticsEmBridges
Aggiornare un bridge EM: UpdateLogAnalyticsEmBridge
Modificare il compartimento di un bridge EM: ChangeLogAnalyticsEmBridgeCompartment

Tipi di destinazione e proprietà raccolte EM

Il bridge EM supporta i seguenti tipi di destinazione e le relative proprietà:

Tipo di destinazione EM	Tipo di entità Log Analytics	Proprietà destinazione EM	Proprietà entità Log Analytics
Oracle High Availability Service	Nodo Oracle Cluster	`NodeName` - `OracleHome`	`node_name` `omc_crs_base` `oracle_home`
Host	Host (AIX) Host (HP-UX) Host (Linux) Host (Solaris) Host (Windows)	Nessuno	Nessuno
OC4J	OC4J	-	`omc_server_log_path`
Oracle HTTP Server	Oracle HTTP Server	`{DOMAIN_HOME}{OracleInstance}` `ComponentName`	`ohs_home` `component_name`
Istanza di database	Oracle Database Instance	- `MachineName` `Port` `ADRHome` `SID` `ServiceName` `OracleHome` `diagnostic_dest` `audit_file_dest`	`audit_dest` `host_name` `port` `adr_home` `sid` `service_name` `oracle_home` `DIAGNOSTIC_DEST` `AUDIT_FILE_DEST`
Sistema di database	Sistema di database Oracle	Nessuno	Nessuno
Oracle Internet Directory	Oracle Internet Directory	`IASInternalName` `OracleInstance`	`ias_internal_name` `oracle_instance`
Listener	Listener Oracle Database	`OracleHome` `ADRHome` `{ORACLE_HOME}/../diag/tnslsnr//{LSNR_ALIAS}/alert` `Machine` `{ORACLE_HOME}/../diag/tnslsnr//{LSNR_ALIAS}/trace`	`oracle_home` `adr_home` `log_dir_path` `host_name` `trace_dir_path`
Pluggable database	Pluggable database Oracle	`Name` `MachineName` `Port` `SID` `ServiceName` -	`pdb_name` `host_name` `port` `sid` `service_name` `domain_name`
Oracle VM Manager	Oracle VM Manager	Nessuno	Nessuno
Pool di Oracle VM Server	Pool di Oracle VM Server	Nessuno	Nessuno
ASM cluster	Gestione automatica dello stoccaggio	Nessuno	Nessuno
Gestione automatica dello stoccaggio	Istanza Automatic Storage Management	`AdrHome`	`adr_home`
Database cluster	Oracle Database	Nessuno	Nessuno
Componente Siebel	Componente Siebel	- `SARMLogDirectory`	`siebel_component_log_file_name` `siebel_component_sarm_log_directory`
Siebel Enterprise	Oracle Siebel Enterprise	Nessuno	Nessuno
Server Siebel	Server Siebel	`filesystem:installdir` `filesystem:logdir` -	`siebel_server_install_dir` `siebel_server_log_dir` `siebel_component_sarm_log_directory`
Cluster Oracle WebLogic	Cluster WebLogic	`DOMAIN_HOME`	`omc_weblogic_cluster_home`
Dominio Oracle WebLogic	Dominio WebLogic	`DOMAIN_HOME` `WebLogicHome`	`domain_home` `weblogic_home`
Oracle WebLogic Server	Server WebLogic	`DOMAIN_HOME` `ServerNames`	`domain_home` `server_names`
Node Manager Oracle WebLogic	Node manager (Gestione nodi) di WebLogic	-	`omc_nodemanager_home`