This section describes how to configure and discover AMD GPU devices for monitoring by Skylar One using the "AMD: GPU Monitoring" PowerPack.
Prerequisites for Monitoring AMD GPU Devices
To configure Skylar One to monitor AMD GPU devices using the "AMD: GPU Monitoring" PowerPack, you must first have the following:
-
SSH credentials with permissions to run the amd-smi command
-
Physical AMD GPU devices that you can align with the Dynamic Applications included in this PowerPack
Creating an SSH/Key Credential for AMD GPU
To configure Skylar One to monitor AMD GPU devices, you must first create an SSH/Key credential. This credential allows the Dynamic Applications in the "AMD: GPU Monitoring" PowerPack to communicate with AMD GPU devices.
The PowerPack includes an example SSH/Key credential that you can edit for your own use.
To configure an SSH/Key credential to access AMD GPU devices:
-
Go to the Credentials page (Manage > Credentials).
-
Locate the "AMD GPU Monitoring - Example" sample credential, then click its actions icon (
) and select Duplicate. A copy of the credential appears, called "AMD GPU Monitoring - Example copy."
-
Click the actions icon (
) for the "AMD GPU Monitoring - Example copy" credential and select Edit. The Edit Credential modal appears.
-
Supply values in the following fields:
-
Name. Enter a new name for the credential.
-
Hostname/IP. Type "%D". Skylar One replaces this variable with the device's IP address.
-
Timeout (ms). Enter the time in milliseconds after which Skylar One stops trying to communicate with the monitored host.
-
Username. Enter the SSH account username that Skylar One uses to connect to the monitored host.
-
Password. Enter the password for the SSH account.
-
Private Key (PEM Format). Enter the SSH private key.
The private key can have a maximum of 64 characters per line. Therefore, you cannot use keys in the OpenSSH format, because that format uses 70 characters per line. When you attempt to save the credential, Skylar One validates that the private key entered is in the correct format. You can save the credential only if the private key is correctly formatted.
- Click .
Creating an SSH/Key Credential for AMD GPU in the Skylar One Classic User Interface
To configure an SSH/Key credential to access an AMD GPU device using the classic Skylar One user interface:
-
Go to the Credential Management page (System > Manage > Credentials).
-
Locate the "AMD GPU Monitoring - Example" credential, then click its wrench icon (
). The Edit SSH/Key Credential modal appears. -
Complete the following fields:
-
Name. Enter a new name for the credential.
-
Hostname/IP. Type "%D". Skylar One replaces this variable with the device's IP address.
-
Timeout (ms). Enter the time in milliseconds after which Skylar One stops trying to communicate with the monitored host.
-
Username. Enter the SSH account username that Skylar One uses to connect to the monitored host.
-
Password. Enter the password for the SSH account.
-
Private Key (PEM Format). Enter the SSH private key.
The private key can have a maximum of 64 characters per line. Therefore, you cannot use keys in the OpenSSH format, because that format uses 70 characters per line. When you attempt to save the credential, Skylar One validates that the private key entered is in the correct format. You can save the credential only if the private key is correctly formatted.
- Click the button.
Discovering AMD GPU Devices
To create and run a discovery session that discovers an AMD GPU root device, perform the following steps:
-
On the Devices page (
) or the Discovery Sessions page (Devices > Discovery Sessions), click the button. The Select page appears.
-
Click the button. Additional information about the requirements for discovery appears in the General Information pane to the right.
-
Click . The discovery wizard appears, starting with the Basic Information page.
-
Complete the following fields:
-
Name. Enter a unique name for this discovery session. This name displays in the list of discovery sessions on the tab.
-
Description. Optional. Enter a short description of the discovery session. You can use the text in this description to search for the discovery session on the tab.
-
Select the organization to add discovered devices to. Select the name of the organization to which you want to add the discovered devices.
-
Click . The Credential Selection page of the Add Devices wizard appears.
-
On the Credential Selection page, locate and select the SSH/ Key credential you created.
-
Click . The Discovery Session Details page of the Add Devices wizard appears.
-
Complete the following fields:
-
List of IPs/Hostnames. Enter the IP address for the AMD GPU root device.
-
Which collector will discover these devices? Select an existing collector to monitor the discovered devices.
-
Run after save. Select this option if you want to run this discovery session as soon as you click .
-
Click to save the discovery session. The Discovery Sessions page displays the new discovery session.
-
If you selected the Run after save option, the discovery session runs immediately, and the Discovery Logs page displays any relevant log messages. If the discovery session locates and adds any devices, the Discovery Logs page includes a link to the Device Investigator page for the discovered device.
Aligning Dynamic Applications to AMD GPU Devices
You can use a device template to save a device configuration and apply it to multiple devices. The "AMD: GPU Monitoring" PowerPack includes the "AMD: GPU Monitor Template," which enables Skylar One to align all Dynamic Applications to the root component device.
Configuring the Device Template
Before you can use the "AMD: GPU Monitor Template," you need to configure the template so that each Dynamic Application in the template aligns with the credential you created earlier.
To configure the device template:
-
Go to the Configuration Templates page (Devices > Templates).
-
Locate the "AMD: GPU Monitor Template" and click its wrench icon (
). The Device Template Editor modal appears. -
Change the name of the template and click . This creates a copy of the template.
-
Click the tab. The Editing Dynamic Application Subtemplates page appears.
-
In the Credentials drop-down field, select the credential that you created for AMD GPU.
-
Click the next Dynamic Application listed in the Subtemplate Selection section on the left side of the page and then select the credential you created in the Credentials field.
-
Repeat step 6 until you have selected the appropriate credential for all of the Dynamic Applications listed in the Subtemplate Selection section.
-
Click .
Using the Device Template to Align Dynamic Applications to AMD GPU Devices
To align the AMD GPU Dynamic Applications to AMD GPU devices:
-
Go to the Device Manager page (Devices > Classic Devices, or Registry > Devices > Device Manager in the classic user interface).
-
Select the checkbox for all devices you want to align with the AMD GPU Dynamic Applications.
-
In the Select Actions field, select the option MODIFY by Template and then click the button. The Device Template Editor modal appears.
-
Complete the following fields:
-
In the Template drop-down field, select the name of the device template you configured earlier.
-
In the Credentials drop-down field, select the credential you created earlier.
-
Click the button, and then click to align the Dynamic Applications to the selected devices.
-
Confirm that the Dynamic Applications were aligned with the selected devices by clicking on a device's wrench icon (
) and clicking the tab. The page lists any Dynamic Applications aligned with the devices.