為您的 Azure 雲端服務 (傳統) 收集效能計數器

發行項
07/24/2024

重要

截至 2024 年 9 月 1 日，所有客戶的雲端服務 (傳統) 均已淘汰。自 2024 年 10 月起，Microsoft 將停止並關閉任何執行中的現有部署，且資料將永久遺失。新部署應該使用 Azure Resource Manager 型的新部署模型 Azure 雲端服務 (延伸支援)。

效能計數器提供一個方法，讓您追蹤您的應用程式和主機的執行程度。 Windows Server 提供與硬體、應用程式、作業系統等等相關的許多不同效能計數器。藉由收集效能計數器並傳送至 Azure，您可以分析此資訊來協助進行更好的決策。

探索可用的計數器

效能計數器是由兩個部分組成，集合名稱 (也稱為分類) 和一或多個計數器。您可以使用 PowerShell 以取得可用效能計數器的清單：

Get-Counter -ListSet * | Select-Object CounterSetName, Paths | Sort-Object CounterSetName

CounterSetName                                  Paths
--------------                                  -----
.NET CLR Data                                   {\.NET CLR Data(*)\SqlClient...
.NET CLR Exceptions                             {\.NET CLR Exceptions(*)\# o...
.NET CLR Interop                                {\.NET CLR Interop(*)\# of C...
.NET CLR Jit                                    {\.NET CLR Jit(*)\# of Metho...
.NET Data Provider for Oracle                   {\.NET Data Provider for Ora...
.NET Data Provider for SqlServer                {\.NET Data Provider for Sql...
.NET Memory Cache 4.0                           {\.NET Memory Cache 4.0(*)\C...
AppV Client Streamed Data Percentage            {\AppV Client Streamed Data ...
ASP.NET                                         {\ASP.NET\Application Restar...
ASP.NET Apps v4.0.30319                         {\ASP.NET Apps v4.0.30319(*)...
ASP.NET State Service                           {\ASP.NET State Service\Stat...
ASP.NET v2.0.50727                              {\ASP.NET v2.0.50727\Applica...
ASP.NET v4.0.30319                              {\ASP.NET v4.0.30319\Applica...
Authorization Manager Applications              {\Authorization Manager Appl...

#... results cut to save space ...

CounterSetName 屬性代表集合 (或分類)，而且是效能計數器與什麼相關的良好指標。 Paths 屬性代表集合的計數器收集。您也可以取得 Description 屬性以取得計數器集合的詳細資訊。

若要取得集合的所有計數器，請使用 CounterSetName 值並展開 Paths 集合。每個路徑項目都是您可以查詢的計數器。例如，若要取得與 Processor 集合相關的可用計數器，請展開 Paths 集合：

Get-Counter -ListSet * | Where-Object CounterSetName -eq "Processor" | Select -ExpandProperty Paths

\Processor(*)\% Processor Time
\Processor(*)\% User Time
\Processor(*)\% Privileged Time
\Processor(*)\Interrupts/sec
\Processor(*)\% DPC Time
\Processor(*)\% Interrupt Time
\Processor(*)\DPCs Queued/sec
\Processor(*)\DPC Rate
\Processor(*)\% Idle Time
\Processor(*)\% C1 Time
\Processor(*)\% C2 Time
\Processor(*)\% C3 Time
\Processor(*)\C1 Transitions/sec
\Processor(*)\C2 Transitions/sec
\Processor(*)\C3 Transitions/sec

這些個別計數器路徑可以新增至您的雲端服務使用的診斷架構。如需有關效能計數器路徑建構方式的詳細資訊，請參閱指定計數器路徑。

收集效能計數器

效能計數器可以針對 Azure 診斷或 Application Insights 新增至您的雲端服務。

Application Insights

雲端服務的 Azure Application Insights 可讓您指定想要收集哪些計數器。在您將 Application Insights 新增至您的專案之後，名為 ApplicationInsights.config 的設定檔會新增至您的 Visual Studio 專案。此設定檔會定義 Application Insights 收集何種類型的資訊並且傳送至 Azure。

開啟 ApplicationInsights.config 檔案並且尋找 ApplicationInsights>TelemetryModules 元素。每個 <Add> 子元素會定義要收集的遙測類型，以及其設定。效能計數器遙測模組類型是 Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.PerformanceCollectorModule, Microsoft.AI.PerfCounterCollector。如果已定義此元素，請勿再次新增。每個要收集的效能計數器會定義在名為 <Counters> 的節點下。以下是收集磁碟機效能計數器的範例：

<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">

  <TelemetryModules>

    <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.PerformanceCollectorModule, Microsoft.AI.PerfCounterCollector">
      <Counters>
        <Add PerformanceCounter="\LogicalDisk(C:)\Disk Write Bytes/sec" ReportAs="Disk write (C:)" />
        <Add PerformanceCounter="\LogicalDisk(C:)\Disk Read Bytes/sec" ReportAs="Disk read (C:)" />
      </Counters>
    </Add>

  </TelemetryModules>

<!-- ... cut to save space ... -->

每個效能計數器表示為 <Counters> 底下的 <Add> 元素。 PerformanceCounter 屬性會定義要收集哪個效能計數器。 ReportAs 屬性是要在 Azure 入口網站中針對效能計數器顯示的標題。您收集的任何效能計數器都會放入入口網站中名為「自訂」的分類。不同於 Azure 診斷，您無法設定收集這些效能計數器並傳送至 Azure 的間隔。使用 Application Insights，會每分鐘收集效能計數器並傳送。

Application Insights 會自動收集下列效能計數器：

\Process(??APP_WIN32_PROC??)% Processor Time
\Memory\Available Bytes
.NET CLR Exceptions(??APP_CLR_PROC??)# of Exceps Thrown / sec
\Process(??APP_WIN32_PROC??)\Private Bytes
\Process(??APP_WIN32_PROC??)\IO Data Bytes/sec
\Processor(_Total)% Processor Time

如需詳細資訊，請參閱 Application Insights 中的系統效能計數器和 Azure 雲端服務的 Application Insights。

Azure 診斷

重要

雖然此資料全都會彙總至儲存體帳戶，但是入口網站不會提供製作資料圖表的原生方法。強烈建議您將其他像是 Application Insights 的診斷服務整合到您的應用程式。

雲端服務的 Azure 診斷延伸模組可讓您指定想要收集哪些計數器。若要設定 Azure 診斷，請參閱雲端服務監視概觀。

您想要收集的效能計數器會在 diagnostics.wadcfgx 檔案中定義。在 Visual Studio 中開啟此檔案並且尋找 DiagnosticsConfiguration>PublicConfig>WadCfg>DiagnosticMonitorConfiguration>PerformanceCounters 元素。新增新的 PerformanceCounterConfiguration 元素作為子項目。這個元素具有兩個屬性：counterSpecifier 和 sampleRate。 counterSpecifier 屬性會定義要收集哪個系統效能計數器集合 (在上一節中概述)。 sampleRate 值表示該值輪詢的頻率。整體而言，所有效能計數器都會根據父代 PerformanceCounters 元素的 scheduledTransferPeriod 屬性值，傳送到 Azure。

如需有關 PerformanceCounters 結構描述元素的詳細資訊，請參閱 Azure 診斷結構描述。

sampleRate 屬性定義的期間會使用 XML 持續時間資料類型來表示效能計數器輪詢的頻率。在下列範例中，速率設為 PT3M，這表示 [P]eriod[T]ime[3][M]inutes：每隔三分鐘。

如需有關 sampleRate 和 scheduledTransferPeriod 如何定義的詳細資訊，請參閱 W3 XML 日期和時間日期類型教學課程中的持續時間資料類型一節。

<?xml version="1.0" encoding="utf-8"?>
<DiagnosticsConfiguration  xmlns="http://schemas.microsoft.com/ServiceHosting/2010/10/DiagnosticsConfiguration">
  <PublicConfig>
    <WadCfg>
      <DiagnosticMonitorConfiguration overallQuotaInMB="4096">

        <!-- ... cut to save space ... -->

        <PerformanceCounters scheduledTransferPeriod="PT1M">
          <PerformanceCounterConfiguration counterSpecifier="\Memory\Available MBytes" sampleRate="PT3M" />
          <PerformanceCounterConfiguration counterSpecifier="\Web Service(_Total)\ISAPI Extension Requests/sec" sampleRate="PT3M" />
          <PerformanceCounterConfiguration counterSpecifier="\Web Service(_Total)\Bytes Total/Sec" sampleRate="PT3M" />
          <PerformanceCounterConfiguration counterSpecifier="\ASP.NET Applications(__Total__)\Requests/Sec" sampleRate="PT3M" />
          <PerformanceCounterConfiguration counterSpecifier="\ASP.NET Applications(__Total__)\Errors Total/Sec" sampleRate="PT3M" />
          <PerformanceCounterConfiguration counterSpecifier="\ASP.NET\Requests Queued" sampleRate="PT3M" />
          <PerformanceCounterConfiguration counterSpecifier="\ASP.NET\Requests Rejected" sampleRate="PT3M" />
          <PerformanceCounterConfiguration counterSpecifier="\Processor(_Total)\% Processor Time" sampleRate="PT3M" />

          <!-- This is a new perf counter which will track the C: disk read activity in bytes per second, every minute -->
          <PerformanceCounterConfiguration counterSpecifier="\LogicalDisk(C:)\Disk Read Bytes/sec" sampleRate="PT1M" />

        </PerformanceCounters>
      </DiagnosticMonitorConfiguration>
    </WadCfg>
    
    <!-- ... cut to save space ... -->

  </PublicConfig>
</DiagnosticsConfiguration>

建立新的效能計數器

可以建立新的效能計數器，供您的程式碼使用。建立新效能計數器的程式碼必須以提升的權限執行，否則會失敗。您的雲端服務 OnStart 啟動程式碼可以建立效能計數器，需要您在提升權限的內容中執行角色。或者，您可以建立以提升權限執行的啟動工作，並且建立效能計數器。如需啟動工作的詳細資訊，請參閱如何設定和執行雲端服務的啟動工作。

若要設定您的角色以提升的權限執行，將 <Runtime> 元素新增至 .csdef 檔案。

<ServiceDefinition name="CloudServiceLoadTesting" xmlns="http://schemas.microsoft.com/ServiceHosting/2008/10/ServiceDefinition" schemaVersion="2015-04.2.6">
  <WorkerRole name="WorkerRoleWithSBQueue1" vmsize="Large">

    <!-- ... cut to save space ... -->

    <Runtime executionContext="elevated">
      
    </Runtime>

    <!-- ... cut to save space ... -->

  </WorkerRole>
</ServiceDefinition>

您可以使用少數幾行程式碼建立及註冊新的效能計數器。使用 System.Diagnostics.PerformanceCounterCategory.Create 方法多載，建立分類和計數器。下列程式碼會先檢查是否有分類存在，如果遺失，就會同時建立分類和計數器。

using System.Diagnostics;
using Microsoft.WindowsAzure;
using Microsoft.WindowsAzure.ServiceRuntime;

namespace WorkerRoleWithSBQueue1
{
    public class WorkerRole : RoleEntryPoint
    {
        // Perf counter variable representing times service was used.
        private PerformanceCounter counterServiceUsed;

        public override bool OnStart()
        {
            // ... Other startup code here ...

            // Define the category and counter names.
            string perfCounterCatName = "MyService";
            string perfCounterName = "Times Used";

            // Create the counter if needed. Our counter category only has a single counter.
            // Both the category and counter are created in the same method call.
            if (!PerformanceCounterCategory.Exists(perfCounterCatName))
            {
                PerformanceCounterCategory.Create(perfCounterCatName, "Collects information about the cloud service.", 
                                                  PerformanceCounterCategoryType.SingleInstance, 
                                                  perfCounterName, "How many times the cloud service was used.");
            }

            // Get reference to our counter
            counterServiceUsed = new PerformanceCounter(perfCounterCatName, perfCounterName);
            counterServiceUsed.ReadOnly = false;
            
            return base.OnStart();
        }

        // ... cut class code to save space
    }
}

當您想要使用計數器時，呼叫 Increment 或 IncrementBy 方法。

// Increase the counter by 1
counterServiceUsed.Increment();

現在，您的應用程式會使用您的自訂計數器，您需要設定 Azure 診斷或 Application Insights 以追蹤計數器。

Application Insights

如先前所述，Application Insights 的效能計數器是在 ApplicationInsights.config 檔案中定義。開啟 ApplicationInsights.config 並尋找 ApplicationInsights>TelemetryModules>Add>Counters 元素。建立 <Add> 子元素，並且將 PerformanceCounter 屬性設為您在程式碼中建立之效能計數器的分類和名稱。將 ReportAs 屬性設為您想要在入口網站中看到的易記名稱。

<ApplicationInsights xmlns="http://schemas.microsoft.com/ApplicationInsights/2013/Settings">

  <TelemetryModules>

    <Add Type="Microsoft.ApplicationInsights.Extensibility.PerfCounterCollector.PerformanceCollectorModule, Microsoft.AI.PerfCounterCollector">
      <Counters>
        <!-- ... cut other perf counters to save space ... -->

        <!-- This new perf counter matches the [category name]\[counter name] defined in your code -->
        <Add PerformanceCounter="\MyService\Times Used" ReportAs="Service used counter" />
      </Counters>
    </Add>

  </TelemetryModules>

<!-- ... cut to save space ... -->

Azure 診斷

如先前所述，您想要收集的效能計數器會在 diagnostics.wadcfgx 檔案中定義。在 Visual Studio 中開啟此檔案並且尋找 DiagnosticsConfiguration>PublicConfig>WadCfg>DiagnosticMonitorConfiguration>PerformanceCounters 元素。新增新的 PerformanceCounterConfiguration 元素作為子項目。將 counterSpecifier 屬性設為您在程式碼中建立之效能計數器的分類和名稱。

<?xml version="1.0" encoding="utf-8"?>
<DiagnosticsConfiguration  xmlns="http://schemas.microsoft.com/ServiceHosting/2010/10/DiagnosticsConfiguration">
  <PublicConfig>
    <WadCfg>
      <DiagnosticMonitorConfiguration overallQuotaInMB="4096">

        <!-- ... cut to save space ... -->

        <PerformanceCounters scheduledTransferPeriod="PT1M">
          <!-- ... cut other perf counters to save space ... -->
          
          <!-- This new perf counter matches the [category name]\[counter name] defined in your code -->
          <PerformanceCounterConfiguration counterSpecifier="\MyService\Times Used" sampleRate="PT1M" />

        </PerformanceCounters>
      </DiagnosticMonitorConfiguration>
    </WadCfg>
    
    <!-- ... cut to save space ... -->

  </PublicConfig>
</DiagnosticsConfiguration>

共用方式為

為您的 Azure 雲端服務 (傳統) 收集效能計數器

探索可用的計數器

收集效能計數器

Application Insights

Azure 診斷

建立新的效能計數器

Application Insights

Azure 診斷

下一步

意見反應

其他資源