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_HOME e INSTALL_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 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 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_HOME e INSTALL_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

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 myhost.example.com and if the preference USE_CUSTOM_HOSTNAME_FROM_TAG is set to tagForHostNameOverride and the Management Agent resource has a free form tag tagForHostNameOverride set to value -customEnvName-, then the name of the Log Analytics Host entity is either -customEnvName-myhost.example.com or myhost.example.com-customEnvName- depending on whether Prefix or Suffix option is specified for the USE_CUSTOM_HOSTNAME_POSITION preference.

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