Add Oracle Automatic Storage Management (ASM)

You can add Oracle Automatic Storage Management entities using the cloud agent command line interface (omcli) with the appropriate JSON files.

Note:

Oracle Management Cloud allows you to add all database components (DB, ASM, listener, etc.) as a single composite entity via the Oracle database system entity type. See Add Oracle Database Systems.

Step 1: Prepare Oracle Automatic Storage Management for monitoring.

Credentials
Monitoring of ASM is supported through credential-based monitoring. For simplicity, use the default asmsnmp user for the ASM monitoring credentials OR any user with both SYSASM and SYSDBA roles.

Step 2: Add the Oracle Automatic Storage Management using omcli and the Appropriate JSON Files

1. Download and extract the required JSON file(s) from the master JSON zip file. See the table below for the specific JSON files you'll need.
2. Edit the file(s) and specify the requisite properties shown below.

   Oracle Automation Storage Management JSON Files and Properties

   Definition File: omc_oracle_asm_sample.json name: Your Oracle ASM entity name. displayName: Your Oracle ASM entity display name which is displayed on the Oracle Infrastructure Monitoring user interface. timezoneRegion: Time zone of your entity. It is recommended that you use the long values IANA-maintained TZ database time zones. For example: America/New_York machine_name: Under “value”, provide the fully-qualified machine name where the Oracle ASM is installed. host_name: Under “value”, provide the fully-qualified host name where the Oracle ASM is installed. port: Under “value”, list the Oracle ASM port. sid: Under “value”, list the Oracle ASM SID. Credential File: omc_oracle_asm_sample_creds.json user_name: Under “value”, within the square brackets, provide the Oracle ASM user name to be used for monitoring. password: Under “value”, within the square brackets, provide the Oracle ASM monitoring user's password. Do not remove the square brackets.

3. Add the entity using omcli.

   omcli add_entity agent DEFINITION_FILE [-credential_file CREDENTIAL_FILE [-encryption_method_gpg]] 

4. Verify the status of the newly added entity.

   omcli status_entity agent DEFINITION_FILE

See step 4. Adding Entities to Your Service of Add Entities Using JSON Files for more information.

Step 3: (Optional but recommended) Set up alerts.

To enable lights-out monitoring, you can set up alert rules to generate alerts and send notifications if your entities have performance issues.

See Set Up Alert Rules and Set Up Alert Thresholds and Notifications.

Troubleshooting

If you run into any issues regarding discovery or monitoring of Oracle Automatic Storage Management, see the following:

• Lack of Data
• Create an Agent Support Bundle