Getting Started
Stack Monitoring provides an automated process to create the necessary groups and polices to make getting started easy. If your organization has special requirements or you wish to use a custom configuration, see Service Requirements for a detailed list of groups and policies required to use Stack Monitoring.
Before you can use the Stack Monitoring service, you must ensure that your Oracle Cloud Infrastructure environment is setup correctly to allow communication between the different components and services. This section explains the steps to set up Oracle Cloud Infrastructure for Stack Monitoring.
Follow these steps to set up your Oracle Cloud Infrastructure environment:
- Step 1: Create or Designate a Compartment to Use
- Step 2: Policy Manager
- Step 3: Install Management Agents
Stack Monitoring Easy Onboarding process will create groups, users, and polices. For more information, see Service Requirements.
Step 1: Create or Designate a Compartment to Use
You can create a new compartment or use an existing compartment to install and configure the Stack Monitoring service. For information about compartments, see Managing Compartments. Stack Monitoring supports the following configurations to create a single-pane of glass for monitoring all resources:
-
All resources are deployed within the monitoring compartment.
-
Resources deployed in a compartment different than the monitoring compartment.
All resources are deployed within the monitoring compartment
Resources deployed in the monitoring compartment may leverage the Management Agent deployed using the Oracle Cloud Agent, to locally monitor both the host and the resources running on the host (WebLogic, Oracle Database, etc).
A monitoring compartment is the where the single-pane of glass for the monitored resources in Stack Monitoring will be used.
Stack Monitoring can automatically monitor all hosts running within the monitoring compartment. For more information see Automatic Promotion.
Resources deployed in a compartment different than the monitoring compartment
Any resource deployed outside of the monitoring compartment, this includes in a different compartment, on-premises resources, or resources deployed in another cloud.
-
Install a Management Agent locally on the host. For more information regarding agent installation see Step 3: Install Management Agents.
-
Generate a Management Agent install key, and select the compartment from the drop-downlist. This is the compartment where the Stack Monitoring single-pane of glass designated as the monitoring compartment.
-
When installing the Management Agent, configure the agent using the install key generated for the monitoring compartment
-
For more information on installing a Management Agent and generating an install key, see Install Management Agents documentation..
Step 2: Policy Manager
To complete the on-boarding of the Stack Monitoring service, from the Oracle Cloud Infrastructure console navigate to Stack Monitoring located under Observability and Management, Stack Monitoring. Select the compartment you wish to monitor, and click Policy Manager. For more information on the steps completed during the on-boarding process, see Create required policies using Policy Manager..
Step 3: Install Management Agents
If Host Auto Promotion and Compute Auto Activation were enabled during onboarding, which is recommended, installing the Management Agent is not a prerequisite for using the Stack Monitoring service. If not, users are expected to follow the appropriate Management Agent documentation.
For OCI Compute instances that leverage the OS Management Service (OSMS), as part of the on-boarding process, Stack Monitoring will create a policy to automatically enable the Management Agent.
For more information about agent installation for OCI Compute instances and on-premises hosts, see Perform Prerequisites for Deploying Management Agents.
The Stack Monitoring plug-in will automatically be enabled within the Management Agent during discovery and promotion.