Einrichten der „.NET Framework “-Trace-Funktion auf Windows

Online bearbeiten

Sie können die Protokollierung von „.NET Framework “ auf „ Windows “-Systemen für eigenständige Anwendungen, Prozesse und „ Windows “-Dienste einrichten, indem Sie die Umgebungsvariablen manuell konfigurieren. Diese Methode ist für Anwendungen erforderlich, die nicht auf IIS gehostet werden.

Dieses Thema behandelt Folgendes:

Vorbereitende Schritte

Online bearbeiten

Führen Sie die folgenden Schritte aus, um die „.NET Framework “-Protokollierung auf Windows einzurichten:

  • Stellen Sie sicher, dass der „ Instana “-Agent auf dem Host-Rechner ausgeführt wird. Siehe „Agent installieren“ unter Windows.
  • Vergewissern Sie sich, dass „ InstanaPCP “ auf dem Host-Rechner ausgeführt wird. InstanaPCP ermöglicht es dem „ Instana “-Agenten, mit Ihrer „.NET Framework “-Anwendung zu kommunizieren. Um zu überprüfen, ob „ InstanaPCP “ ausgeführt wird, öffnen Sie den Task-Manager unter Windows und suchen Sie nach InstanaPCP.exe.
  • Stellen Sie sicher, dass Ihre Anwendung unter .NET Framework 4.5.2 oder einer neueren Version läuft.
  • Informationen zum Support anzeigen.

Tracing für eigenständige Anwendungen aktivieren

Online bearbeiten

Der Agent „ Instana “ aktiviert die Ablaufverfolgung nicht automatisch für alle auf „.NET “ basierenden Anwendungen. Beispielsweise sind Systemanwendungen von „ Windows “ oder eigenständige Prozesse ausgeschlossen, sofern sie nicht ausdrücklich konfiguriert wurden.

IIS und „ WebSphere Application Server “ sind so konfiguriert, dass der Profiler durch die Einstellung entsprechender Umgebungsvariablen automatisch angefügt wird. Einzelne Prozesse müssen jedoch manuell konfiguriert werden.

Um die Ablaufverfolgung für einen Prozess zu aktivieren, setzen Sie die folgenden Umgebungsvariablen:

Hinweis:
  • Wenn Sie Ihre Anwendungen unter bestimmten Benutzern ausführen, legen Sie die Umgebungsvariablen auf Benutzerebene fest.
  • Setzen Sie die Umgebungsvariablen, bevor Sie den Prozess starten.
SET COR_ENABLE_PROFILING=1
SET COR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}

Sie können diese Einstellungen in ein Batch- oder Shell-Skript einfügen, das die Umgebungsvariablen setzt und anschließend Ihren Prozess startet.

Tracing für „ Windows “-Dienste aktivieren

Online bearbeiten

Wenn Sie „ Windows -Dienste“ ausführen, können Sie die Einstellungen der Umgebungsvariablen für jeden Dienst einzeln in der Registrierung hinterlegen. Durch Hinzufügen dieser Einstellungen haben Sie mehr Kontrolle bei der Auswahl der zu überwachenden Dienste.

Führen Sie die folgenden Schritte aus, um die Umgebungsvariable für „ Windows -Dienste“ einzurichten:

  1. HKLM\System\CurrentControlSet\Services\serviceNameGo zum Registrierungseditor im Verzeichnis.
  2. EnvironmentFüge den MULTI_SZ Wert mit dem Namen hinzu.
  3. Falls MULTI_SZ nicht vorhanden ist, kopieren Sie die Variablen COR_ENABLE_PROFILING, COR_PROFILER und INSTANA_ALLOW_ROOT_EXIT_SPAN in diesen Wert.
  4. Um den Inhalt eines MULTI_SZ Werts festzulegen, fügen Sie wie im folgenden Beispiel gezeigt pro Zeile ein Schlüssel-Wert-Paar hinzu:
    COR_ENABLE_PROFILING=1
COR_PROFILER={FA8F1DFF-0B62-4F84-887F-ECAC69A65DD3}
INSTANA_ALLOW_ROOT_EXIT_SPAN=1
  5. Drücke nach der letzten Zeile die Eingabetaste.
  6. Starten Sie den Dienst „ Windows “ neu, damit die Änderungen wirksam werden.