PowerShell Day-to-Day Admin Tasks: Monitoring Performance

By reading performance counters from services such as SQL Server or Exchange, you can get a wealth of performance information. By automating the process of gathering and storing appropriate counters, you can routinely check a range of devices quickly using visual tools such as PerfMon. By then creating your own counters, you can add counter-based metrics to anything that can be measured programmatically, such as services, applications, processes such as ETL, or deployments.

The series so far:

  1. Automating Day-to-Day PowerShell Admin Tasks – Part 1: Jobs and Workflow
  2. PowerShell Day-to-Day Admin Tasks – Part 2: WMI, CIM and PSWA
  3. PowerShell Day-to-Day Admin Tasks – Part 3: Monitoring Performance
  4. PowerShell Day-to-Day Admin Tasks – Part 4: Securing Scripts
  5. PowerShell Day-to-Day Admin Tasks – Part 5: Events and Monitoring
  6. PowerShell Day-to-Day Admin Tasks - Part 6: Real Time IT Dashboard

Whether you are a systems administrator or an administrator of either database or networks, it is likely that you have a daily struggle with the task of gathering and analysing performance counters in order to monitor performance of the devices in your care. If the systems are operational and respond to their workload quickly, then this indicates that all is likely to be well. But how do you make sure routinely? Can you easily spot signs of potential trouble?

I’ve already demonstrated the PowerShell methods of accessing and interacting with your devices. So you’re ready to understand the many opportunities that the various PowerShell commands provide to make your life easier and less monotonous. This article will describe how to collect, export, display and analyse data from performance counters.

As this article is relatively important for a SysAdmin, I will provide several basic examples just to illustrate how data about performance counters is gathered and analysed. Then, at the end, we will look at more practical examples.

Gathering data from performance counters

It is possible to gather data performance that will help us with the diagnosis of certain problems. Indeed, we can access many different types of data on the device that we’re monitoring: data such as Processor, Memory or Disk amongst others. In order to do that, the command Get-Counter was introduced with Windows 8 and Windows Sever 2012. Let’s start by obtaining available groups on our local device:

This command gives us a great deal of information in the results, so I will only display the names of the groups.

2249-figure0-ac5c570b-bcd8-403e-ba03-44e

Figure1 – List of groups available

As well as the core groups, or sets, of counters, certain additional groups may be available depending on the machine you execute this command on. Here, the device has the “Hyper-V” role available so there are corresponding groups of counters. If we want to drill down into the counters available for Hyper-V, we can then display several groups starting with “Hyper-V”. The complete list of these groups on my device can be obtained with the following command:

2249-figure6-1922d3ca-f744-476a-858f-b63

Figure2 – List of groups beginning with “Hyper-V”

Here, I’ve used the Out-GridView Cmdlet to represent this data in a more readable form.

As a matter of interest, you can find out the total number of available groups at your disposal with the following commands:

2249-figure2-fc85aaa9-1b2a-47d8-a778-e6a

Figure3 – Number of available groups

Accessing the counter data

The counter parameter associated with the Get-Counter command allows us to specify one or more counters to analyze. In a first instance, I’ll retrieve the available memory on my Hypervisor:

Note:When you obtain the result, the data is given in a pre-formatted “cooked value”. This refers to the formula for calculating performance data. A performance counter can be ‘Raw’, ‘Second’ and ‘cooked’. An expression containing the first two gives the “cooked values“. These latter ones are a representation of the values understandable by humans.

Now, I want to verify that the virtual machine displayed on my Hypervisor has enough memory. (This is not to train you on the learning of Hyper-V, for this, I merely suggest this excellent article on the concept of Dynamic Memory) For this, I check the result of the “Average Pressure” counter. If the latter is below 100, then the virtual machine has sufficient memory:

The sign * means that all processes of the overall virtual machines. But I can point out a particular process:

This is fine but in this example, I already knew the names of the counters I needed. Occasionally, however, I will need to find out the available counters in a new group. In this example, I have a particular interest in monitoring the performance of Hyper-V. Therefore, I retrieve in a first instance the overall paths of this group of performance counters into a $HyperVInformations variable. Then I display the counters:

2249-figure17-31ac5598-10fb-4234-a9ed-17

Figure4 – List of counters

If I wish to display only one counter as I did in previous examples, then I just need to indicate it in the Get-Counter cmdlet:

Obtaining several data sets

By default, only a single set of data is retrieved. However, we are likely to be interested in seeing the progressive values of a counter over a longer period of time. The first idea that comes to mind is to manually run the same command at regular intervals. Is this a solution? No, I must automate this action. That’s perfect, because PowerShell has foreseen this with the parameter MaxSamples. It allows us to specify the number of sets of data to retrieve. I can also use the parameter -Continuous to gather results ad infinitum, using CTRL + C to stop the retrieving process.

This command allows us to verify the memory of our host for a 10 second interval (10 sets * 1 second), with one reading every second:

2249-figure7-ef23004f-2076-4398-861b-80c

Figure5 – Display of memory on the data of 10 sets

It is, of course, possible to specify a sampling time-interval (in seconds) to this command, as by default, the values are retrieved every second. So as to have a preview of the memory usage, we will specify 10 sets of data taken one every minute over ten minutes:

2249-figure8-ada60eb2-9355-43bf-a0cd-bbe

Figure6 – Time interval every minute

You can indicate several counters within the same command by passing them as an array:

2249-figure9-242a52f3-eba9-4672-b7e1-dba

Figure7 – Multiple counters

Remote counter access

We can interrogate remote devices to obtain their performance counter data. For this, the ComputerName parameter is used. As well as specifying a single computer, we can use it to interrogate a number of devices to check that the device behaves correctly. We can pass the cmdlet a list of computers as an array.

2249-figure10-b0f733cd-9f2c-4bce-b53f-d2

Figure8 – Remote data access

You may also use a text folder that contains a list of servers to be analyzed: for this, you need to indicate it the following to the parameter computername:

Note:The main restriction is that Get-Counter has no Credentials parameter. The local account that you use to run PowerShell must be in the ‘Performance Monitor Users’ group on every remote server. If this proves to be a problem, you must use the Invoke-Command in the following way:

The counters and jobs

You will have gathered that, to obtain data performance over a time period, you will need that time period for execution. Furthermore, it is likely that this data must be gathered over set periods of time, Such as outside office hours. Therefore, I recommend to use PowerShell jobs as we have already seen in the first part of these series.

Herewith a very simple example:

2249-figure13-64567026-2756-47f5-af4f-16

Figure9 – Jobs and counters

Then I only need to launch a Receive-Job to obtain the result of my command.

2249-figure14-e2b7d933-a70c-46df-b7dd-61

Figure10 – Receive-Job

So finally, let’s imagine that several processes are being performed on my server during the night and I wish to inspect the way that disk space has changed overnight when I need the data the following morning. I plan the job so that it begins at 1 am on the “Free Space” counter for all the disks:

You just have to run Get-ScheduledJob to get the status of this job. Then, the csv file will be created and you can inspect data into Microsoft Excel when it is done. I will explain later how to export results with Export-Counter.

Counters and Microsoft products

We can easily get performance counters from the more common Microsoft products.

Microsoft Exchange.

I can get the number of users connected on the Web Access with the following command:

I can also obtain the number of clients actually connected on my CAS server:

2249-figure11-8a707d27-9c3d-4d80-848c-16

Figure11 – Exchange 2010 and counters

And finally the number of operations per second:

System Center Operations Manager.

Here I wish to know the number of workflows running on my SCOM server:

Note:A workflow, in this context, means a process being executed and launched by the SCOM agent.

2249-figure16-2b49598d-453c-4127-83a4-5f

Figure12 – SCOM 2012 R2 and counters

Exporting data

At this point in the article, you have all you need to obtain the performance of your devices. To end this article on the counters, there is one more important thing to learn: the display of results in graphic forms. This will ease the reading and analysis. The command Export-Counter allows to create a file with the extension .BLG that may be read with the Windows Performance Monitor tool.

Let’s take the following example:

Note:The argument Force allows to force the overwriting of the file if it already exists.

A file is thereby created with counters contained in $CtrList. This data may also be registered in CSV or TSV formats. You may then select or deselect counters to facilitate the reading of the graphics.

2249-figure12-9d736a04-74a0-4f9a-a9be-8e

Figure13 – Performance Monitor

To go further

You may wish to create your own counters for very specific needs. There are a wide range of counters already provided for all sorts of requirements but the facility to add your own opens up all sorts of possibilities. You can use custom counters to instrument server-based processes such as ETL or even monitor the performance metrics of applications such as website transactions. You can really amuse yourself with this facility as it is very powerful, but you’ll need a good understanding of the mechanism.

Here is a simple example that you can build on.

In a first instance, I must define a few variables:

  • The name of the category,
  • an associated description “help”
  • the type of category (simple instance or multiple instances).

Then I define two objects: one object of data collection that will contain one or several data objects.

Here is the creation of the category of counter: “My-Custom-Category”

That’s fine but the category is for the moment empty. It would be interesting to create counters in it. To do that I must create one or more PerformanceCounter objects that can take several arguments within its parameters. In my example, I indicate:

  • the name of the category in which it will be created
  • its type (See the possible types)
  • a description
  • and if I can modify it or not (True/False)

And finally, I give it a value with RawValue:

See the complete example and comments for a more detailed understanding:

2249-figure19-e5dfa011-21ff-44b0-a503-bf

Figure14 – Full example of a created custom counter

Once your tests completed, you can delete the categories:

Note:You must close your PowerShell console so that the category will not be displayed.

Conclusion

Performance counters are the basic way of handling a vast range of measurements that you need in order to ensure that your servers are trouble-free. With the basic principles I’ve illustrated, you should be able to gather performance data for such performance categories as Disk, Processor, Memory, Hyper-V, SQL Server, Exchange and so on, for all your servers and devices. With custom counters, you will even be able to monitor the business processes within applications.

I suggest that you create different scripts for each category of counter. Then it will be simple to plan and execute them on demand on the list of devices you provide. I personally organize my counter-value-retrieving data scripts in this manner.

In the absence of a third-party monitoring tool that answers all your requirements, I find that performance counters are a very good approach to analyze the behavior of the devices. By using the Export-Counter command, I can execute a true analysis and also send comprehensible results to non-technical people.

The most difficult task, in my opinion, is to find out which counters are most relevant to your needs and thereby reduce reporting to the bare minimum. It is far too easy to obtain too much data on the devices and thereby increase the implementation time of your scripts. You can be sure that the time you spend in refining your performance-counter metrics will be gained tenfold when the time comes for you to analyze a critical situation on one of your servers, or spot an issue before it becomes a big problem. PowerShell is here to help you attend to detail with the minimum of effort..