Erweitern der Ablaufverfolgung

Artikel
06/05/2023

Das Beispiel zum Erweitern der Ablaufverfolgung veranschaulicht, wie die Ablaufverfolgungsfunktion von Windows Communication Foundation (WCF) erweitert wird, indem im Client- und Dienstcode benutzerdefinierte Aktivitätsablaufverfolgungen geschrieben werden. Das Schreiben benutzerdefinierter Aktivitätsablaufverfolgungen ermöglicht dem Benutzer, Ablaufverfolgungsaktivitäten zu erstellen und Ablaufverfolgungen in logischen Arbeitseinheiten zu gruppieren. Es ist auch möglich, Aktivitäten über Übertragungen (innerhalb desselben Endpunkts) und Weitergabe (über verschiedene Endpunkte) zu korrelieren. In diesem Beispiel wird Ablaufverfolgung sowohl für den Client als auch den Dienst aktiviert. Weitere Informationen zur Aktivierung der Ablaufverfolgung in den Konfigurationsdateien von Clients und Diensten finden Sie unter Ablaufverfolgung und Nachrichtenprotokollierung.

Dieses Beispiel basiert auf Erste Schritte.

Hinweis

Die Setupprozedur und die Buildanweisungen für dieses Beispiel befinden sich am Ende dieses Themas.

Ablaufverfolgung und Aktivitätsweitergabe

Mithilfe von benutzerdefinierter Aktivitätsweitergabe kann der Benutzer eigene Ablaufverfolgungsaktivitäten erstellen, um Ablaufverfolgungen in logische Arbeitseinheiten zu gruppieren, Aktivitäten über Übertragungen und Weitergabe zu korrelieren und die Leistungskosten der WCF-Ablaufverfolgung (z. B. die Kosten des von einer Protokolldatei belegten Festplattenspeicherplatzes) zu verringern.

Hinzufügen benutzerdefinierter Quellen

Benutzerdefinierte Ablaufverfolgungen können sowohl zu Client- als auch Dienstcode hinzugefügt werden. Wenn den Client- oder Dienstkonfigurationsdateien Ablaufverfolgungsquellen hinzugefügt werden, können diese benutzerdefinierten Ablaufverfolgungen aufgezeichnet und im Service Trace Viewer-Tool (SvcTraceViewer.exe) angezeigt werden. Der folgende Code zeigt, wie der Konfigurationsdatei eine benutzerdefinierte Ablaufverfolgungsquelle namens ServerCalculatorTraceSource hinzugefügt wird.

<system.diagnostics>
    <sources>
        <source name="System.ServiceModel" switchValue="Warning" propagateActivity="true">
            <listeners>
                <add type="System.Diagnostics.DefaultTraceListener" name="Default">
                    <filter type="" />
                </add>
                <add name="xml">
                    <filter type="" />
                </add>
            </listeners>
        </source>
        <source name="ServerCalculatorTraceSource" switchValue="Information,ActivityTracing">
            <listeners>
                <add type="System.Diagnostics.DefaultTraceListener" name="Default">
                    <filter type="" />
                </add>
                <add name="xml">
                    <filter type="" />
                </add>
            </listeners>
        </source>
    </sources>
    <sharedListeners>
       <add initializeData="C:\logs\ServerTraces.svclog" type="System.Diagnostics.XmlWriterTraceListener"
        name="xml" traceOutputOptions="Callstack">
            <filter type="" />
        </add>
    </sharedListeners>
    <trace autoflush="true" />
</system.diagnostics>
....

Korrelieren von Aktivitäten

Zum Korrelieren von Aktivitäten direkt zwischen Endpunkten muss für das propagateActivity-Attribut in der true-Ablaufverfolgungsquelle der Wert System.ServiceModel festgelegt werden. Außerdem muss, um Ablaufverfolgungen weiterzugeben, ohne über WCF-Aktivitäten zu gehen, „ServiceModel-Aktivitätsablaufverfolgung“ deaktiviert werden. Dies ist im folgenden Codebeispiel zu erkennen.

Hinweis

Das Deaktivieren von ServiceModel-Aktivitätsablaufverfolgung ist nicht dasselbe, wie die von der switchValue-Eigenschaft angegebene Ablaufverfolgungsebene zu deaktivieren.

<system.diagnostics>
    <sources>
      <source name="System.ServiceModel" switchValue="Warning" propagateActivity="true">

    ...

       </source>
    </sources>
</system.diagnostics>

Verringern von Leistungskosten

Wenn ActivityTracing in der System.ServiceModel-Ablaufverfolgungsquelle ausgeschaltet wird, wird eine Ablaufverfolgungsdatei erstellt, die nur benutzerdefinierte Aktivitätsablaufverfolgungen, jedoch keine der ServiceModel-Aktivitätsablaufverfolgungen enthält. Das Ausschließen von ServiceModel-Aktivitätsablaufverfolgungen führt zu einer viel kleineren Protokolldatei. Allerdings geht dabei die Möglichkeit verloren, WCF-Verarbeitungsablaufverfolgungen zu korrelieren.

Einrichten, Erstellen und Ausführen des Beispiels

Stellen Sie sicher, dass Sie die Beispiele zum einmaligen Setupverfahren für Windows Communication Foundation ausgeführt haben.
Um die C#- oder Visual Basic .NET-Edition der Projektmappe zu erstellen, befolgen Sie die unter Building the Windows Communication Foundation Samplesaufgeführten Anweisungen.
Wenn Sie das Beispiel in einer Einzelcomputer- oder einer computerübergreifenden Konfiguration ausführen möchten, folgen Sie den Anweisungen unter Durchführen der Windows Communication Foundation-Beispiele.

Siehe auch

AppFabric-Überwachungsbeispiele

Freigeben über