Showing results for 
Search instead for 
Did you mean: 
Create Post

Server & Application Monitor (SAM) 2020.2 is Now Generally Available

Server & Application Monitor (SAM) 2020.2 is now available and can be downloaded from your Customer Portal and In prior releases, SAM 2019.4.x brought hardware health for Nutanix clusters, and an initial version of the API poller. Version 2020.2 is the next release following SAM 2019.4.1 and is compatible with Orion Platform 2020.2.

What's New in SAM 2020.2


SAM 2020.2 release notes & system requirements 

Orion Platform 2020.2 release notes & system requirements 

API Poller


In SAM 2019.4, API pollers were accessible from each node details page, from the management widget. 

 2019.4.x API poller2019.4.x API poller

In SAM 2020.2, the entry point for API pollers has not changed, but there are more exciting options. 

Out-of-the-box API Poller templates


From the node management widget you have the ability to 'assign' an out-of-the-box API Poller template.

2020.2 API Poller2020.2 API Poller


Clicking 'Assign' will allow you to access 23 new templates (including updated versions of our Microsoft Azure Application Monitor Templates). See our Application Poller Template guide for a deep dive into the metrics available with these templates. The existing classic Azure application monitor templates are still supported, but consider these new Azure API poller templates an API friendly supplement that handles your credentials more securely, with an easier path to update for the metrics that you'd like to see. 

Assign API Poller Template WizardAssign API Poller Template Wizard

API Poller improvements


2020.2 API poller improvements include new authentication support for OAuth 2.0, API key, and Bearer Token. Orion proxy setting support, skipping the ssl certification verification, multiple requests per API poller and node macro support are also welcome additions for this release. 



With the ability to utilize OAuth 2.0 combined with the out-of-the-box Azure templates, you now have several items in this release that will aid in monitoring the full Azure stack.   Configure your custom API poller to monitor against any of the Azure endpoints with an OAuth 2.0 credential by following these steps.  

1. Create a API poller from scratch or use one of the existing Azure out-of-the-box API poller templates.

2. Click 'Configure' in the upper right hand corner of the screen


3. Select OAuth 2.0 Authorization

4. Click 'New credential'

Set up a new credentialSet up a new credential


Similarly, if you wanted to monitor against the rich Microsoft REST ecosystem (e.g. to extend your O365 monitoring), simply configure your API poller to monitor Microsoft Graph endpoints, using the relevant access token URL and scope. 

The out-of-the-box SolarWinds AppOptics Monitored Services API poller template is a great example of how to use the node macros support for the 2020.2 API poller and also showcases how you would configure multiple requests per API poller. 

collapsed request statecollapsed request state

Each of the requests in this API poller follow a similar format to read data from the AppOptics API.

If you simply configured your Basic Authentication for the template, you would not see data until you configured the macro in the request url. In this example, that macro is: ${API_AppOpticsServiceName} in others like the VMware vCenter Inventory template the macro would be ${IPAddress}. Macros such as ${IPAddress} are standard for the node, but where would you expect to set up something like ${API_AppOpticsServiceName} or your own custom macro? The answer is the custom property editor. 

Before I jump over to the custom property editor, let me take a look at the monitored services that AppOptics is configured to monitor. 

On the home page, there's a quick list of monitored services. A likely candidate for me to pull into SAM for additional monitoring, alerting and visualization would be the "web-tier" service. 

AppOptics Home Summary pageAppOptics Home Summary page


AppOptics web-tier services viewAppOptics web-tier services view


Now that I've identified the service, let's jump over to Settings -> All Settings -> Manage Custom Properties



Click Add Custom PropertyClick Add Custom Property

Ensure that you're adding a custom property based on selected object type Node



Property name would be API_AppOpticsServiceNameProperty name would be API_AppOpticsServiceName

Select the node(s) that you'll be applying the custom property to, and specify the value to be the name of the service "web-tier"Select the node(s) that you'll be applying the custom property to, and specify the value to be the name of the service "web-tier"


Ensure that you're configured for the right authentication, and that's it! your AppOptics monitored service data is now integrated into SAM and available for alerting and for exciting visualizations of that data. Without changing the template, and how it's constructed, you can specify different web services for different nodes using the same API poller template. 


Visualize your API polled results in the AppStack, Orion Maps and the new Dashboard Framework. 


Polling is one thing, but you'll also have access to visualize your new API polled applications and infrastructure in the new dashboard framework, AppStack and of course in the stunning release of Orion Maps. 

Let's take a look first at the classic AppStack™ visualization and see what you can anticipate. 

Click to EnvironmentClick to Environment

For those of you who aren't familiar with AppStack, take a look at this product blog post  Revisiting AppStack.  

Once you click on Environment and scroll down, you can see a new category of API Pollers appears. 

API Pollers in AppStackAPI Pollers in AppStack

This will give you a quick visualization of status across your configured API pollers, and will also allow you to spotlight issues across the application stack.  

In Orion Maps, since 2019.4, API pollers have been an entity that you can visualize in relationship to your infrastructure. However, with the new Orion maps, this functionality is even more valuable with the addition of static backgrounds and other features. I highly recommend reading through the Orion Platform 2020.2 Orion Maps deep dive to see the full scope of what's available.

As an example, here we are monitoring Office 365 using a combination of our classic Office 365 Application Monitor templates, paired with the API poller template for Microsoft Azure Active Directory, and of course covering the on-premises Active Directory with AppInsight for Active Directory. Additionally, we're also using a community sourced Azure AD Connect Monitor template created by one of our amazing THWACK MVPs to have additional coverage on the AD connect sync status from the viewpoint of the domain controller.  Bringing in NetPath™ for network path analysis, transaction checks for Office 365 logins, monitoring of the virtual infrastructure and underlying storage utilizes the power of the full stack visibility that SolarWinds provides. The full picture of the Office 365 service and all factors that feed into the availability of that service is fully on display using one of our very best visualization tools on the Orion platform. 

Full Stack Office 365 MonitoringFull Stack Office 365 Monitoring



Lastly, a new exciting option for visualizing your API poller is available in the new Orion Dashboards. 

A fully configured dashboardA fully configured dashboard


Click to Manage DashboardsClick to Manage Dashboards  
Each of these widgets are highly configurable and utilizes the power of our SWQL to allow you to put anything you want into the dashboard of your dreams.

image.pngChoose your widget typeChoose your widget type


The easiest way to see your API polled data is by saving a PerfStack™ project, because you can utilize that for the time series widget.   

Save your PerfStack projects for reuse on dashboardsSave your PerfStack projects for reuse on dashboards



Coming back to the time series widget you can edit the model to select that saved PerfStack project that contains your API polled data. 



You now have API polled data on our new dashboard framework. 



On the other widgets, such as the table widget, these are fueled by SWQL queries, which of course can be used to bring in API polled data. 



Check the option to show advanced and specialized entitiesCheck the option to show advanced and specialized entities


In the release candidate, customers were diving into the new capabilities of the API poller and putting these visualizations to the test. One fantastic example can be found with this thread as a customer integrated their SolarWinds Pingdom data into the new dashboard as a widget: How to make a Pingdom widget in the new Orion Modern Dashboards. If you would like to follow in his footsteps, I highly recommend utilizing the Pingdom API poller template that we've provided for transaction check monitoring to get you started. 

There is so much to explore in the new dashboard framework, so I highly recommend taking a look at the available deep dives on the topic to really get a sense of the scope of improvement available to you. 

Increased Scale


I'm excited to announce that for both component and node-based licensed customers, the component limit for your SAM installation is now supported for 550,000 components. 

For node-based licensed customers utilizing the included additional polling engines, those polling engine limits have been improved to support 40,000 components. 

But to really achieve the best scale in monitoring your environment, we have some best practices for you to eke out every last drop of value. 

WinRM monitoring has long been touted as the best way to be doing your WMI monitoring, and our internal tests held true to those claims. We used SAM to monitor a SAM installation and confirmed that utilizing WinRM stabilized usage of compute and memory across the board for predictable monitoring overhead. For those of you who aren't familiar, we've had blog posts as far back as 2015 that are just as relevant to best practices WMI monitoring today. See: What is WinRM & How do you configure it? 

We already require WinRM to be configured for our most powerful templates such as AppInsight for IIS, but we needed to ensure that all of our application templates had consistent support for WinRM. I'm happy to say that in 2020.2 this requested work has been fulfilled. 

While the preferred option by many customers to configure WinRM with group policy, we do provide a free tool to help enable a server. The Remote Execution Enabler for PowerShell is available to download here and also in your customer portal

Under Additional Components, look for the Remote Execution Enabler for PowerShellUnder Additional Components, look for the Remote Execution Enabler for PowerShell

Once your target server is configured for WinRM, you can then ensure that all application templates applied to that monitored node are using WinRM as the preferred transport method. As this might be a process that you haven't rolled out immediately across all nodes, we've taken that into account by ensuring there's a fallback mechanism to preserve monitoring continuity. If using the WinRM transport for WMI queries fails, the backup will utilize DCOM/RPC calls. Feel free to enable your nodes for WinRM while editing a nodes properties, and keep an eye out for any triggered alerts that will warn you if this fallback is occurring for any nodes. 


Scroll down to the WinRM section when adding or editing a node to enable WinRM for application templatesScroll down to the WinRM section when adding or editing a node to enable WinRM for application templates


Additionally our component monitors have been updated for configuration to use WinRM, so you can set this up for specific templates. 



In a rush? Set up your SAM installation globally to use WinRM for all nodes in the Advanced Configuration settings page.  




By utilizing these improvements paired with our updated scale guidelines, we're happy to say you're able to monitor more of your critical infrastructure than ever. 

Application Monitor Template Updates


With this release we have additional updates to our existing Application Monitor templates. 

Click to the Manage Application Monitor Template page to see the 'New in 2020.2' additions. The SAM release notes walks through these templates in detail, as well as some updates to our JMX monitoring to help support those that were needing support for the latest WildFly and JBoss versions. 


Updated templates are also being uploaded to THWACK. Keep an eye out for ongoing updates like:

Nutanix Ready Certified


In SAM 2019.4, we provided Nutanix Hardware Health along with the Virtualization Manager (VMAN) technical preview of basic Nutanix monitoring. Since that time, VMAN's official Nutanix monitoring is generally available in 2020.2 and SAM has been Nutanix Ready Certified. This badge indicates that SAM can run on the Nutanix AHV hypervisor, and also utilizes the Nutanix REST APIs to work with AHV. This is functionality is validated for how we monitor Nutanix hardware health, and also through our ability to monitor Nutanix through our Application Monitor templates, and through the improvements in the API poller. 



Nutanix AHV official support through VMAN and SAMNutanix AHV official support through VMAN and SAM

Upgrade Now for Your Fastest Upgrade Yet


Are you ready to upgrade? 

Do you have a gigantic globally distributed environment? 

Are you stuck on the last version of SAM that supported Windows 2012 R2 & SQL 2012? 

I have wonderful news for you. This is going to be your best upgrade to date. 


Click into My Orion Deployment and start your upgrade from the Updates & Evaluations tab. 


My upgrade was so good, I'm already up to dateMy upgrade was so good, I'm already up to date 

This release allows those customers who have had globally distributed environments to pre-stage their upgrades. By clicking the 'Pre-Stage Files' button, you'll be able to prepare for that change window in advance. Additionally, there are speed improvements overall in the upgrade process. See the Orion platform deep dive for more details on the many improvements that went into the upgrade process for this release. 

Those of you who are still on the 2012 compatible releases? The even better news for you is that the Orion 2020.2 release of all products will support your upgrade without you needing to update your underlying infrastructure. That's right, we support Windows 2012 R2 and SQL 2012, so don't hesitate and upgrade now. 

Amazon Marketplace


If you're not convinced that you want to upgrade and your company is on a path to cloud, this bit of news is for you. 

SAM 2020.2 and other products are now in the Amazon Marketplace. Similar to our Azure Marketplace offering, with a few clicks you'll have a SAM 2020.2 instance running in no time flat. 


Search for SolarWindsSearch for SolarWinds



What's Next


Looking for what we'll be working on next? Take a look at our What We're Working On For SAM roadmap. Don't see something you really need? Advocate for the features you want in SAM Feature Requests



Labels (3)

In regards to this... Feel free to enable your nodes for WinRM while editing a nodes properties, and keep an eye out for any triggered alerts that will warn you if this fallback is occurring for any nodes. 

...where do I go to find if its failing back to WMI for my entire environment?

This is great but I have a question about this:

"Those of you who are still on the 2012 compatible releases? The even better news for you is that the Orion 2020.2 release of all products will support your upgrade without you needing to update your underlying infrastructure. That's right, we support Windows 2012 R2 and SQL 2012, so don't hesitate and upgrade now"

So what if I have NPM 12.3 NTA 4.2.3 and SQL Server 2014 and a WS 2012 for Flow Storage Database?

I assume that I will be able to upgrade my modules to 2020's version, but, NTA 2020 still needs SQL Server 2016 SP1 or later right?

So will I still need to add a new SQL Server 2017 or later?

thanks in advanced!

How can I view/confirm what protocol (WMI vs WinRM vs RPC vs ?) is being used when polling the nodes...for both agent and agentless?

Where can I find all the new widgets?

Lots of good things in the update, however, there are a couple thing which have created some major headaches for us.

We run in FIPS mode.

1. With 2020.2 we can no longer push agents from the orion core.

2. Neither the Gold Master nor the GPO agent install work properly as the agent configuration utility fails to run due to folder permissions on the c:\program files (x86)\Solarwinds\agent folder

Opened tickets with support but no resolution yet.  This is forcing me to manually login to each server needing an agent and since we have SCM, that is all machines.

WOW!!! @serena SAM is my lifeblood, my turn to ... along with NPM.  I am so very pleased with what you all continue to do with these great products.  Although I will remain in my private cloud for a couple of years, it is a relief to know that you all will have me covered when we hit the skyline!  Thanks to everyone for their hard work and contributions to this great product! 

@cfizz34  hi there! Great question. you'll see a triggered alert that will let you know that fallback is occurring. Just look at your alerts under Alerts & Activities! 

@cfizz34  regarding your second question, the work being described is specific to application templates. For the full package across node monitoring, we're tracking that work under and when @adam.hert starts actively working on this, you would see that feature request being flipped to "What we're working on" 

@peter6tz  you are correct! NTA still has a requirement for SQL 2016 SP1 or higher. So in this case, you could keep your main Orion db as 2012, set up a new (ideally SQL 2017) specifically for NTA and upgrade your environment. That would keep your main db & OS at 2012, but the only net new set up would be the NTA database. @jreves  can give you more specifics on how you can best utilize this set up for optimal efficiency for NTA!  

@cfizz34  for the new dashboard widgets, click Settings -> Manage Dashboards -> Add Modern Dashboard. 

I also highly recommend you look at @tony.johnson 's document that details out the new dashboard improvements 

@jelliston  that's certainly disappointing to hear. There were certain aspects of agent deployment that were tied to solutions that we utilize that were found to not meet certain FIPS requirements, and were addressed in this release to ensure that we are fully compliant with the requirements there. The product team is aware that in some cases this increases complexity for you as our customer, and we're working through options to see what can be done as we work with third party vendors and others. @tony.johnson  will be keeping an eye out so please keep letting us know what else you're seeing that is affected for FIPS mode monitoring. 

@zennifer it's a pleasure to hear your feedback on the hard work that the SAM team has delivered. We're constantly looking to improve. As you start transitioning away from private cloud, we would absolutely love to chat with you more directly on your evolving needs. Please keep us in the loop on your journey so we can keep pace! Any time that you'd like to do a show me session or give direct feedback @adam.hert  and I are at your service. 

Thank you, Serena.


How do we change the endpoints for Azure Gov?


nice work on the API poller 🙂

But one question I have: Where can I find the API Credentials in the Orion Database or in the SWIS Object tree. There are not in the Orion.Credentials table.

Thnx and kind regards,


Hi @serena,

is the view limitation functionality build in to the new API Poller version?

Backround for question:

We have a lot of views for separate teams, every team just see what they have to (Windows-Team:only windows nodes...)

If we configure an API Poller alert, every Solarwinds user see this alert even if a view limitation is active or not


Thnx and kind regards,


Hi  @serena,

I think I found a little issue with the use of Node properties in the API Poller. The Poller does not find the property from time to time. You need to rewrite the content into it and it works again. 

Does anybody else sees that issue?

Thnx and regards



Version history
Revision #:
27 of 27
Last update:
‎06-05-2020 11:16 AM
Updated by: