Entitys verwalten

Eine Entity ist eine Ressource in Log Analytics, die zur Referenzierung des echten Assets auf Ihrem On-Premise-Host oder virtuellen Host verwendet wird. Nachdem Sie diese Entity in Log Analytics ermittelt haben, können Sie sie mit einer Logquelle verknüpfen und die Logerfassung daraus aktivieren.

Nützliche Ressourcen:

• Weitere Informationen zu einer Entity finden Sie unter Begriffe und Konzepte von Log Analytics.

• Informationen zum Erstellen einer Entity finden Sie unter Entity erstellen, die Ihre logausgebende Ressource darstellt. Darüber hinaus können Sie Entitys mit Log Analytics zu einem späteren Zeitpunkt bearbeiten, von einem Compartment in einen anderen verschieben und verschiedene andere Verwaltungsaufgaben ausführen, wie unten aufgeführt.

• Informationen zum Initiieren der Discovery von Entitys wie in einem Package integrierten Anwendungen, Datenbanken, Middleware und anderen Komponenten finden Sie unter Automatische Discovery von Entitys und Logerfassung.

• Eine Entity muss einen Entitytyp aufweisen. Fast 100 von Oracle definierte Entitytypen sind bereits verfügbar. Siehe In Log Analytics modellierte Entitytypen. Sie können auch benutzerdefinierte Entitytypen erstellen. Wenn eine Entity erstellt wird, definiert ein Entitytyp die Eigenschaften, mit denen der Speicherort der Logdateien gesucht wird. Beispiel: Im Entitytyp Oracle Database müssen Sie Pfadwerte für Eigenschaften wie ADR_HOME, ORACLE_HOME und INSTALL_HOME angeben. Sie können neue Entitätstypen mit der REST-API oder CLI erstellen. Siehe Log Analytics-API und Befehlszeilenreferenz.

• Wenn Sie Management-Agents zum kontinuierlichen Erfassen von Logs verwenden, müssen Sie eine Quellen-Entity-Verknüpfung konfigurieren, um eine Quelle zur Erfassung der Logdaten durch bestimmte Entitys zu aktivieren. Siehe Quellen-Entity-Verknüpfung verwalten.

• Um die Logerfassung aus einer Entity zu stoppen, heben Sie die Verknüpfung der Entity mit der Quelle auf. Siehe Logerfassung von einer Entity stoppen.

Um andere Aktionen mit der Entity auszuführen, wählen Sie auf der Seite Entitys im Abschnitt Entitys - Geltungsbereich das Compartment der Entity aus. Grenzen Sie dann die Suche nach der Entity ein, indem Sie den Entitytyp im Abschnitt Filter auswählen. Nachdem Sie die Entity identifiziert haben, klicken Sie in der Zeile der Entity auf das Symbol "Aktionen" :

• Details anzeigen: Die Entityseite wird angezeigt. Auf der Registerkarte Entityinformationen können Sie den Entitytyp, die OCID, den Erstellungstyp, das Compartment der Entity, die Details des Management Agent, den Zeitpunkt der Erstellung und der letzten Aktualisierung sowie die zugehörigen Quellen anzeigen. Klicken Sie neben Management Agent auf das Symbol "Bearbeiten " , um die Agent-Informationen zu aktualisieren. Auf der Registerkarte Tags können Sie die mit der Entity verknüpften Tags anzeigen. Klicken Sie auf die Schaltfläche Tag hinzufügen, um ein Tag hinzuzufügen.

  Klicken Sie außerdem auf der Entityseite auf die Schaltfläche Bearbeiten, Ressource verschieben, Tags hinzufügen oder Löschen, um die entsprechenden Aktionen auszuführen.

• Bearbeiten: Das Dialogfeld Entity bearbeiten wird angezeigt. Um weitere Eigenschaften hinzuzufügen, können Sie im Abschnitt "Eigenschaften" auf die Schaltfläche "Hinzufügen" klicken und Eigenschaftsname und Eigenschaftswert angeben. Klicken Sie auf Änderungen speichern.

  Diese Eigenschaften werden zum Ermitteln des Speicherorts der Logdateien verwendet. Beispiel: Im Entitytyp Oracle Database müssen Sie Pfadwerte für Eigenschaften wie ADR_HOME, ORACLE_HOME und INSTALL_HOME angeben.

• Daten hinzufügen: Das Dialogfeld Agent-basierte Logerfassung konfigurieren oder Logerfassung für OCI-Ressourcen konfigurieren wird angezeigt, je nachdem, ob die Entity eine OCI-Ressource oder eine Nicht-OCI-Ressource ist. Die Assistenten unterstützen Sie dabei, die Entity mit einer geeigneten Quelle zu verknüpfen. Dadurch werden der Parser und der Filter so eingerichtet, dass die Logdatensätze verarbeitet werden, die aus der Entity fließen.

• Dateien hochladen: Der Assistent zum Hochladen von Dateien wird geöffnet. Folgen Sie den Schritten im Assistenten, um Logdateien hochzuladen, die mit der Entity verknüpft sind. Dies ist besonders nützlich, um einen Batch von Dateien hochzuladen, die nicht Teil der kontinuierlichen Logerfassung sind, oder Dateien, die zu einem Zeitraum gehören, der außerhalb des für die Erfassung definierten Zeitraums liegt.

• OCID kopieren: Die OCID der Entityressource wird kopiert. Sie können diese Ressource damit überall in Oracle Cloud Infrastructure referenzieren.

• Ressource verschieben: Das Dialogfeld Ressource zu einem anderen Compartment verschieben wird angezeigt. Wählen Sie unter den Optionen das Compartment aus, in das Sie die Entity verschieben möchten, und klicken Sie auf Ressource verschieben.

• Tag hinzufügen: Siehe Tags zu Log Analytics-Ressourcen hinzufügen.

• Löschen: Möglicherweise müssen Sie einige der alten oder nicht verwendeten Entitys löschen, um die Servicelimits von Log Analytics einzuhalten. Siehe Limits nach Service in der Oracle Cloud Infrastructure-Dokumentation. Um die Entity zu löschen, bestätigen Sie den Vorgang im Dialogfeld Entity löschen.

  Hinweis
  
  

  Die Entitys, die Sie mit der Entitylösch-API gelöscht haben, können in einer der folgenden Situationen erneut in Ihrer Entityliste angezeigt werden:

  • Neue Logs werden für die gelöschten Entitys über Service Connector Hub- oder Object Storage-Collections übertragen.

  • Neue EM-Bridgeuploads enthalten die gelöschte Entity.