Add a cloud account
This topic applies only to the following products:
SolarWinds Observability Self-Hosted
IPAM — NAM — NPM — SAM — VMAN
Before proceeding, make sure the cloud account is configured for the SolarWinds Platform and have your cloud account credentials handy.
-
In SolarWinds Platform Web Console, click Settings > Cloud Discovery. This opens the Manage Cloud Accounts page.
-
Click Add Cloud Account.
-
Choose your cloud provider (Amazon Web Services, Microsoft Azure, or Google Cloud Platform) and click Next.
-
In Cloud Account Display Name, type a name for the account you want to see in the web console.
-
Based on the selected provider, enter your cloud access credentials, and click Next.
If you are not certain the credentials you entered are correct, you can click the Test Connection button to test them before continuing.
If an error occurs, verify account credentials and confirm that accounts are configured for the SolarWinds Platform.
AWS
For an AWS account, provide the Access Key ID and Secret Access Key. See How to quickly find and update your access keys in AWS documentation.
For required permissions, see Establish AWS IAM permissions.
Azure
For an Azure account, provide the following credentials, available in the Azure Portal:
- Subscription ID
- Tenant/Directory ID
- Client/Application ID
- Application Secret Key
For tips on finding Azure credentials in the Azure Portal, see the article Configure Microsoft Azure for cloud monitoring in the SolarWinds Platform.
Azure uses different terms for the same credential:
SolarWinds Platform Web Console reference Microsoft Azure reference Notes Subscription ID Subscription ID - Used by Microsoft to manage billing.
- Grants access to the Azure Portal.
- Governs access to and use of Azure services.
- Each deployed resource is linked to only one subscription.
Tenant/Directory ID Directory ID
Tenant ID
- Linked to an Active Directory (AD) app that enables the SolarWinds Platform to access Azure.
-
See Get a Tenant ID in the Azure Portal. (© 2019, Microsoft Corp., available at https://docs.microsoft.com, obtained on January 23, 2019)
Client/Application ID Client ID
Application ID
- Used to grant permissions.
- Often called the Client ID in external applications.
- See Getting an Application ID and authentication key. (© 2019, Microsoft Corp., available at https://docs.microsoft.com, obtained on January 23, 2019)
Application Secret Key Application Secret Key
Authentication Key
Client Secret
Client Secret Key
- See Getting an Application ID and authentication key. (© 2019, Microsoft Corp., available at https://docs.microsoft.com, obtained on January 23, 2019)
When you generate a secret Key in the Azure Portal, record it immediately. Otherwise, you will need to a generate a new key later.
GCP
For a GCP account, provide the following credentials, available in the Google console.
-
On API Polling options, review your options. You can keep the defaults and click Next.
-
(Optional) Disable automatic API polling for instances/VMs currently linked to the account, as well as for future instances/VMs launched for the account.
To avoid exceeding polling limits, consider toggling Enable API Polling off when adding a cloud account to block polling for new instances launched and then discovered for an account. You can enable monitoring for individual instances later.
-
(Optional) Change the default polling frequency — 5 minutes.
-
(Optional) Click Manage Alerts to configure alerts for the account. See Manage cloud monitoring alerts.
Depending on your account permissions, you may not have access to this option.
-
-
On Monitored Regions, ensure all regions you want to monitor are selected and click Next.
You can filter instances/VMs that appear by state, region, availability zone, platform, or OS. If an instance/VM is shutdown or not accessible, this icon appears:
.
By default, all new instances/VMs related to a cloud user account are monitored and the default polling frequency is 5 minutes.
After an account is added, the SolarWinds Platform begins polling all instances or VMs linked to the new account for status and metrics every five minutes. Click Dashboards > Cloud to display the Cloud Summary page and review instances/VMs for the new account.
If you selected Google as the provider, be aware that all discovered regions are monitored, regardless of your selection. Region-specific monitoring will be added in a future version.
-
On the Monitored Resources page, select resources you want to monitor.
-
Monitor all supported resources: Automatically monitors all currently supported and future resources.
-
Monitor entities by tags: Monitors all entities with a specific tag. Select this option and add the tag. Supported only in SolarWinds Observability Self-Hosted.
If Monitor entities by tags is chosen as the Resources Monitoring Method for your Azure cloud account but no tags are provided, all entities will be monitored.
-
Monitor selected entities: Select individual entities to monitor. Expand the relevant cloud component and select resources to monitor.
-
Network — Select network resources, such as GCP Network, Azure ExpressRoute, Load Balancers or Virtual Network Gateways.
If DNS scanning is available, you can adjust the DNS scanning interval.
-
Storage — Select cloud storage to monitor.
-
Compute — Select instances, services, or virtual machines to monitor.
How to select virtual machines for monitoring
Select Virtual Machines to monitor all currently detected and future virtual machines. To change this:
-
Click Edit.
-
To prevent newly launched machines from being added for monitoring, toggle Automatically monitor any future entities off.
-
Select only the VMs to monitor.
-
Click Monitor.
-
-
Database — Select databases to monitor.
-
-
-
Click Finish. Your resources will be added for monitoring.
-
After setup, you will be redirected to the Manage Cloud Accounts window, where you can add or edit cloud resources.
Now you can view your cloud resources in the web console (My Dashboards > Cloud > New Cloud Summary). See Explore cloud instances and VMs.
If you only want specific users to see the new cloud account data, restrict users from seeing instances/VMs for the new account in the SolarWinds Platform Web Console. See Hide cloud account data for specific users
Hide cloud account data for specific users
After adding a cloud account, you can modify user account settings in the SolarWinds Platform Web Console to control which users can access cloud accounts via the Cloud Summary page.
To restrict SolarWinds Platform users from adding, editing, or removing managed cloud instance nodes, modify account permissions in the AWS Management Console or the Azure Portal.
To hide or configure a specific view for summary and instance information, modify the SolarWinds Platform account settings.
- In the SolarWinds Platform Web Console, click Settings > All Settings, locate the User Accounts section, and click Manage Accounts.
- Select an account and click Edit.
- Locate and expand Cloud Monitoring Settings to configure the page to display for the Cloud Summary View.
- On the Cloud Summary page, expand Virtual Infrastructure Monitor Settings and locate the Cloud Instance Details View option.
- If an instance/VM is Manage a cloud instance or VM as a SolarWinds Platform node, set the Cloud Instance Details View option to Node Details - Cloud. Otherwise, leave it set to Default.
- Click Submit.