PoShMon is an open source PowerShell-based server and farm monitoring solution. It's an "agent-less" monitoring tool, which means there's nothing that needs to be installed on any of the environments you want to monitor - you can simply run or schedule the script from a regular workstation and have it monitor a single server or group of servers, using PowerShell remoting. PoShMon is also able to monitor "farm"-based products like SharePoint, in which multiple servers work together to provide a single platform. For details on why I built PoShMon, see the bottom of this page.
Some of the key features / benefits of PoShMon are:
PoShMon is available on the PowerShell Gallery so you can either download it from this GitHub page or even install it directly from the gallery onto your local workstation using
PS> Install-Module -Name PoShMon
While PoShMon is indeed "agent-less", it does need to execute remote PowerShell commands against the servers in question. As a result, you need to ensure that PowerShell remoting is correctly configured and also that you are running PoShMon under an account that has the correct rights to connect to the server remotely and execute the requisite commands. You also need to make sure you're not going to encounter the classic 'Double Hop' issue. If you're already remotely administering your environment you're probably fine, but have a look at the quick Prerequisite Guide to confirm / set up what you need.
(Below is a quick overview - for more, please visit the more complete Getting Started Guide) Once you've installed PoShMon, you can have a look at the Samples folder to get an idea how to use it. As an example, to monitor a farm of web servers you can use
$poShMonConfiguration = New-PoShMonConfiguration {
General `
-EnvironmentName 'Intranet Farm' `
-MinutesToScanHistory 15 `
-ServerNames 'WebServer1','WebServer2' `
OperatingSystem `
-EventLogCodes 'Critical'
WebSite `
-WebsiteDetails @{
"http://intranet" = "Read our terms"
}
Notifications -When OnlyOnFailure {
Email `
-ToAddress "IntranetTeam@Company.com" `
-FromAddress "Monitoring@company.com" `
-SmtpServer "EXCHANGE.COMPANY.COM" `
}
}
$monitoringOutput = Invoke-OSMonitoring -PoShMonConfiguration $poShMonConfigurationSome things to note on the above:
Invoke-OSMonitoring. The lines above are just setting up your specific configuration.Here's another example, to monitor a SharePoint farm
$poShMonConfiguration = New-PoShMonConfiguration {
General -EnvironmentName 'SharePoint' -MinutesToScanHistory 1440 -PrimaryServerName 'SPAPPSVR01' -ConfigurationName SpFarmPosh -TestsToSkip "SPDatabaseHealth"
OperatingSystem -EventLogCodes 'Error','Warning'
WebSite -WebsiteDetails @{
"http://intranet" = "Read our terms"
"http://extranet.company.com" = "Read our terms"
}
Notifications -When All {
Email -ToAddress "SharePointTeam@Company.com" -FromAddress "Monitoring@company.com" -SmtpServer "EXCHANGE.COMPANY.COM"
}
}
$monitoringOutput = Invoke-SPMonitoring -PoShMonConfiguration $poShMonConfigurationPrimaryServerName instead of ServerNames. Instead of a list of servers, you need only to supply PoShMon with details of a "primary" server (you can choose any of the SharePoint servers, but typically this is an "application" or "batch" server, on which the main monitoring work will occur) and it will use SharePoint's API to determine the remaining servers.Invoke-SPMonitoring instead of Invoke-OSMonitoring. "EnvironmentName", which appears in notifications (emails etc.) is also changed to something more suitable.Notifications -When All instead of Notifications -When OnlyOnFailure because we want notifications (emails or similar) in all cases for daily monitoring, unlike for Critical monitoring where we only want to be alerted of major issues. This is also why the EventLogCodes have been changed.$monitoringOutput) is not required, of course, but it's helpful if you want to do anything with it, like try automatically correct regular issues in your environment.After that, simply run the script and it will perform an on-demand monitoring of the servers or environments. Of course, you might like to schedule these monitoring tests to run automatically, so see the next section for how to do this.
Ad-hoc monitoring can be useful to troubleshoot specific issues, but mostly we want our monitoring to be automated and scheduled. Because PoShMon simply consists of PowerShell scripts, to have then be scheduled we can rely on simple Windows Task Scheduler, and just set the Tasks to run on a reasonable basis. Here are some example Task Scheduler definitions that can be imported. The first runs "Critical" level monitoring, so it runs every 15 minutes, skips some of the longer-running and less essential tests and notifies only on failure, whereas the latter runs the full barrage of tests on a nightly basis and send a detailed breakdown.
That's all there is to it! Hopefully PoShMon is of use to you and of course feel free to contribute to the project, there's tons more that can be done!
Of course there are loads of monitoring systems and tools out there, both paid and free / open source ones. However, there are two main reasons I initially built PoShMon:
I wanted to grow my PowerShell knowledge and there didn't seem to be anything purely PowerShell based that could offer what I wanted
Many of the tools don't have a lot of product depth. For instance, many Windows monitoring tools can do basic disk / memory / event log monitoring for SharePoint servers but few can actually give me SharePoint-specific metrics, like how healthy the Search service is, what Timer jobs have failed, or whether any of the servers need to be upgraded (note that many of these tests can be greatly improved). I'm hoping that PoShMon becomes the home for powerful, specialised monitoring of many other products and platforms, like Exchange, SQL Server, CRM and more.
1.3.0
1.2.0
1.1.1
1.1.0
1.0.0
0.15.1
0.15.0
0.14.0
0.13.0
0.12.0
See here for full Changelog