Verwenden von Leistungsindikatoren mit dem SQL-Adapter

BizTalk Adapter Pack-Clients können die Leistungsindikatoren verwenden, um die Leistung der Adapter zu messen. Das BizTalk Adapter Pack-Setupprogramm erstellt die Leistungsindikatorkategorie "Microsoft BizTalk-Adapter für SQL Server" zusammen mit der Adapter Pack-Installation.

Leistungsindikator "LOB-Zeit (kumulativ)"

Die Kategorie BizTalk .NET Adapter für SQL verfügt über einen Leistungsindikator namens "LOB Time (Cumulative)". Dieser Leistungsindikator gibt die Zeit in Millisekunden an, die die SQL Server Clientbibliothek benötigt, um eine Aktion abzuschließen, die der Adapter initiiert. Der SQL-Adapter erstellt eine instance des Leistungsindikators für jede Aktion für einen bestimmten SQL Server instance und Datenbanknamen. Die Instanzen werden im folgenden Muster erstellt:

<processId>:<appDomainId>:<endpointId>:<actionId>  

Der <endpointId> wird als <sql_server_name>, <instance_name>, <database_name>abgeleitet.

Die <actionId> wird wie folgt abgeleitet:

• Zum Öffnen einer Verbindung lautet die Aktions-ID "Öffnen".

• Bei eingehenden Vorgängen lautet die Aktions-ID "Eingehender Vorgang".

• Bei ausgehenden Vorgängen ist die Aktions-ID die Aktion des aufgerufenen Vorgangs, wobei "/" durch einen Unterstrich "_" ersetzt wird. Außerdem wird der Aktions-ID das Präfix "ExecuteScalar", "ExecuteReader" oder "ExecuteNonQuery" vorangestellt, abhängig von der Methode, die der Adapter intern zum Ausführen des Vorgangs für die SQL Server-Datenbank verwendet. Der Adapter verwendet beispielsweise intern die ExecuteReader-Methode, um eine gespeicherte Prozedur in SQL Server auszuführen. Die Aktions-ID für die gespeicherte Prozedur MyProcedure lautet also:

  ExecuteReader_Procedure_dbo_MyProcedure  
  

  Der Leistungsindikator wird erst initialisiert, nachdem der Adapter den ersten Aufruf der SQL Server Datenbank ausgeführt hat. Außerdem ist die InstanceLifetime-Eigenschaft des Leistungsindikators auf "Process" festgelegt, was bedeutet, dass der Leistungsindikator nicht mehr vorhanden ist, sobald das Programm, das den Leistungsindikator erstellt, beendet wird.

Hinweis

Die Genauigkeit des Leistungsindikators lobzeit (kumulative) beträgt 16 Millisekunden.

Aktivieren von Leistungsindikatoren

Die Leistungsindikatoren können durch Festlegen der Bindungseigenschaft EnablePerformanceCounters aktiviert oder deaktiviert werden. Um Leistungsindikatoren zu aktivieren, legen Sie die Bindungseigenschaft EnablePerformanceCounters auf True fest. Um Leistungsindikatoren zu deaktivieren, legen Sie EnablePerformanceCounters auf False fest. Standardmäßig ist die Eigenschaft auf False festgelegt. Weitere Informationen zu dieser Bindungseigenschaft finden Sie unter Informationen zum BizTalk-Adapter für SQL Server Adapterbindungseigenschaften.

Leistungsindikatoren und das WCF LOB Adapter SDK

Durch Ändern des Werts der EnablePerformanceCounters-Bindungseigenschaft wird auch der Wert des entsprechenden Leistungsindikators für das WCF LOB Adapter SDK geändert. Außerdem ist die Bindungseigenschaft für das WCF LOB Adapter SDK statisch, während die Bindungseigenschaft für den SQL-Adapter dynamisch ist. Wenn also zwei Instanzen der SQL-Adapterbindung in der Anwendungsdomäne vorhanden sind und die EnablePerformanceCounters-Bindungseigenschaft auf True in der einen und False in der anderen festgelegt ist, wird der adapterspezifische Leistungsindikator in der einen aktiviert und in der anderen deaktiviert. Da die Bindungseigenschaft für das WCF LOB Adapter SDK jedoch statisch ist, wird sie entweder auf True oder False festgelegt, je nachdem, welcher Wert zuletzt angegeben wurde.

Weitere Informationen

Problembehandlung beim SQL-Adapter