Gestisci entità
Un'entità è una risorsa in Log Analytics che viene utilizzata per fare riferimento all'asset reale nell'host in locale o nell'host virtuale. Dopo aver rilevato questa entità in Log Analytics, è possibile associarla a un'origine log e abilitare la raccolta log da essa.
Risorse utili:
-
Per ulteriori informazioni su un'entità, vedere Termini e concetti di Log Analytics.
-
Per creare un'entità, vedere Creare un'entità per rappresentare la risorsa che invia il log. Inoltre, Log Analytics consente di modificarlo in un secondo momento, spostarlo da un compartimento all'altro ed eseguire diversi altri task di gestione come elencato di seguito.
-
Per avviare la ricerca automatica di entità quali applicazioni pacchettizzate, database, middleware e altri componenti, vedere Ricerca automatica di entità e raccolta di log.
-
Un'entità deve avere un tipo di entità. Sono già disponibili quasi 100 tipi di entità definiti da Oracle. Vedere Tipi di entità modellati in Log Analytics. È inoltre possibile creare tipi di entità personalizzati. Quando viene creata un'entità, un tipo di entità definisce le proprietà utilizzate per individuare la posizione dei file di log. Ad esempio, in un tipo di entità Oracle Database è necessario fornire i valori del percorso per le proprietà quali
ADR_HOME,ORACLE_HOMEeINSTALL_HOME. È possibile creare nuovi tipi di entità utilizzando l'API REST o l'interfaccia CLI. Vedere API Log Analytics e Riferimento riga di comando. -
Quando si utilizzano Management Agent per raccogliere continuamente i log, è necessario configurare un'associazione origine-entità per consentire a un'origine di entità specifiche di raccogliere i dati di log. Vedere Gestisci associazione origine-entità.
-
Per arrestare la raccolta di log da un'entità, annullare l'associazione dell'entità dall'origine. Vedere Arresta raccolta log da un'entità.
Per eseguire altre azioni sull'entità, nella pagina Entità selezionare il compartimento dell'entità e limitare la ricerca dell'entità selezionando il tipo di entità nella barra di ricerca. Dopo aver identificato l'entità, fare clic sull'icona Azioni
nella riga dell'entità:
-
Visualizza dettagli: viene visualizzata la pagina Entità. Nella scheda Informazioni sull'entità è possibile visualizzare il tipo di entità, il relativo OCID, il tipo di creazione, il compartimento in cui risiede, i dettagli del Management Agent, l'ora di creazione e ultimo aggiornamento e le origini associate. Fare clic sull'icona Modifica
accanto a Agente di gestione per aggiornare le informazioni sull'agente. Nella scheda Tag è possibile visualizzare le tag associate all'entità. Fare clic sul pulsante Aggiungi tag per aggiungerne uno.
Inoltre, fare clic sul pulsante Modifica, Sposta risorsa, Aggiungi tag o Elimina nella pagina dell'entità per eseguire le azioni corrispondenti.
-
Modifica: viene visualizzata la finestra di dialogo Modifica entità. Per aggiungere altre proprietà, fare clic sul pulsante Aggiungi nella sezione Proprietà e specificare i valori Nome proprietà e Valore proprietà. Fare clic su Salva modifiche.
Queste proprietà vengono utilizzate per individuare la posizione dei file di log. Ad esempio, in un tipo di entità Oracle Database è necessario fornire i valori del percorso per le proprietà quali
ADR_HOME,ORACLE_HOMEeINSTALL_HOME. -
Aggiungi dati: viene visualizzata la finestra di dialogo Configura raccolta log basata su agente o Configura raccolta log per risorse OCI a seconda che l'entità sia una risorsa OCI o una risorsa non OCI. Le procedure guidate consentono di associare l'entità a una fonte appropriata. In questo modo, vengono impostati il parser e il filtro per elaborare i record di log che provengono dall'entità.
-
Carica file: viene aperta la procedura guidata Carica file. Seguire i passi della procedura guidata per caricare i file di log associati all'entità. Ciò è particolarmente utile per caricare un batch di file che non fanno parte della raccolta di log continua o quelli che appartengono a un intervallo di tempo esterno a quello definito per la raccolta.
-
Copia OCID: l'OCID della risorsa entità viene copiato. Puoi usarlo per fare riferimento a questa risorsa ovunque in Oracle Cloud Infrastructure.
-
Sposta risorsa: viene visualizzata la finestra di dialogo Sposta risorsa in un compartimento diverso. Dalle opzioni, selezionare il compartimento in cui si desidera spostare l'entità e fare clic su Sposta risorsa.
-
Aggiungi tag: vedere Aggiungi tag alle risorse di Log Analytics.
-
Elimina: potrebbe essere necessario eliminare alcune delle entità precedenti o non utilizzate per conformarsi ai limiti del servizio di Log Analytics. Consulta Limiti per servizio nella Documentazione di Oracle Cloud Infrastructure. Per eliminare l'entità, confermare nella finestra di dialogo Elimina entità.
Nota
Le entità eliminate mediante l'API di eliminazione entità possono essere nuovamente visualizzate nell'elenco delle entità in una delle seguenti circostanze:
-
Viene eseguito il push dei nuovi log per le entità eliminate tramite l'hub connettore servizio o le raccolte di storage degli oggetti.
-
I nuovi caricamenti del bridge EM contengono l'entità eliminata.
-
Gestisci preferenze entità
È possibile gestire le preferenze predefinite per le entità tramite il gruppo di preferenze entityLifecycle. Creare criteri IAM per consentire agli utenti di leggere, aggiornare ed eliminare le preferenze entità.
Per informazioni dettagliate sui gruppi di preferenze e sui criteri IAM per le preferenze, vedere Preferenze delle operazioni del servizio Log Analytics.
Affinché l'API REST gestisca le preferenze in Oracle Log Analytics, vedere Log Analytics API Reference.
Argomenti:
- Preferenze entità nel gruppo preferenze entityLifecycle
- Tipi di entità per la preferenza AUTO_DELETE_SCH_ENTITIES_OF_TYPES
Preferenze entità nel gruppo preferenze entityLifecycle
| Funzione | Nome preferenza | Valori consentiti | Dettagli |
|---|---|---|---|
| Ciclo di vita delle entità agente e host in Oracle Log Analytics | AUTO_CREATE_AGENT_HOST_ENTITY |
VERO/FALSO |
TRUE (valore predefinito): le entità per l'agente e l'host vengono create automaticamente. FALSO: le entità per l'agente e l'host non vengono create. |
AUTO_DELETE_AGENT_ENTITY |
VERO/FALSO |
FALSE (valore predefinito): le entità agente non vengono eliminate quando vengono eliminati i Management Agent. TRUE: le entità agente vengono eliminate quando i Management Agent vengono eliminati. |
|
AUTO_DELETE_HOST_ENTITY |
VERO/FALSO |
FALSE (valore predefinito): le entità host non vengono eliminate quando vengono eliminati i Management Agent. TRUE: le entità host vengono eliminate quando i Management Agent vengono eliminati. |
|
| Eliminazione delle entità create automaticamente per i log ricevuti tramite l'hub connettore servizio in Oracle Log Analytics | AUTO_DELETE_SCH_ENTITIES_OF_TYPES |
Elenco separato da virgole dei tipi di entità supportati / _ALL_ / <empty> (nessun set di valori) |
<vuoto> (nessun set di valori) (valore predefinito): le entità non vengono eliminate. _ALL_: le entità vengono eliminate per tutti i tipi supportati quando vengono eliminate le risorse OCI di base. Lista separata da virgole: le entità vengono eliminate per i tipi di entità specificati quando vengono eliminate le risorse OCI di base. |
| Denominazione personalizzata per entità host create automaticamente in Oracle Log Analytics | USE_CUSTOM_HOSTNAME_FROM_TAG |
<tagKeyName> dai tag in formato libero dell'agente |
Per impostazione predefinita, Oracle Log Analytics utilizza il nome host fornito dalla risorsa Management Agent durante la creazione dell'entità Host. Per eseguire l'override di questo nome host, è possibile impostare una tag in formato libero nella risorsa Management Agent. Il valore della tag viene utilizzato per sostituire il nome utilizzato per l'entità host. Se la preferenza è impostata e la tag in formato libero non è impostata nella risorsa Management Agent, l'entità host non viene creata. Il valore della tag è il prefisso (predefinito) o il suffisso al nome host fornito dall'agente. Example: If the hostname reported by Management Agent service is |
USE_CUSTOM_HOSTNAME_POSITION |
Prefisso/suffisso | Vedere i dettagli per USE_CUSTOM_HOSTNAME_FROM_TAG.
|
Tipi di entità per la preferenza AUTO_DELETE_SCH_ENTITIES_OF_TYPES
| Tipo di entità Log Analytics | Risorsa OCI |
|---|---|
| oci_analytics_cloud_instance | Analytics Cloud |
| oci_api_gateway | Gateway API |
| oci_apm_domain | Dominio APM |
| oci_compute_instance | Calcola |
| oci_data_flow_application | Flusso di dati |
| oci_devops_build_pipeline | Pipeline sviluppo DevOps |
| oci_devops_build_pipeline_stage | Fase pipeline di build DevOPS |
| oci_devops_build_run | Esecuzione della pipeline di build DevOops |
| oci_devops_deployment | Implementazione DevOps |
| oci_devops_deployment_pipeline | Pipeline di distribuzione DevOps |
| oci_devops_deployment_stage | Fase di distribuzione DevOps |
| oci_emailsender | Consegna tramite e-mail |
| oci_event_rule | Regole di evento |
| oci_functions_app | Applicazioni Functions |
| oci_functions_function | Funzioni |
| oci_load_balancer | Load balancer |
| oci_media_workflow | Workflow servizi multimediali |
| oci_media_workflow_job | Job workflow servizi multimediali |
| oci_network_firewall | Firewall di rete |
| oci_opctloperatorcontrol | Database - Controllo dell'accesso dell'operatore Oracle |
| oci_os_bucket | Bucket di storage degli oggetti |
| oci_service_connector | Connettore servizio |
| oci_vcn | Networkd cloud virtuale |
| oci_vcn_subnet | Subnet VCN |
| oci_vcn_vnic | VNIC VCN |
| oci_vpn_ipsecconnection | Connessione VPN IPSec |
| oci_vpn_ipsectunnel | Tunnel VPN IPSec |
| oci_webappfirewall | Web Application Firewall |
| omc_kubernetes_cluster | OKE |
| omc_opc_ics_instance | Istanza di Integration Cloud Service |
| omc_opc_ics_integration | Integrazione di Integration Cloud Service |