Monitor Metrics
You can monitor the health, capacity, and performance of your Oracle Blockchain Platform resources by using metrics, alarms, and notifications.
Required IAM Policy
To monitor resources, you must be given the required type of access in a policy written by an administrator, whether you're using the Cloud console or the REST API with an SDK, CLI, or other tool. The policy must give you access to the monitoring services as well as the resources being monitored. If you try to perform an action and get a message that you don’t have permission or are unauthorized, confirm with your administrator the type of access you've been granted and which compartment you should work in. For more information on user authorizations for monitoring, see the Authentication and Authorization section for the related service: Monitoring or Notifications.
Available Metrics: oci_blockchainplatform
The metrics listed in the following table are automatically available for any Oracle Blockchain Platform that you create. You don't need to enable monitoring on the resource to get these metrics.
Metric | Metric Display Name | Unit | Description |
---|---|---|---|
CpuUtilization |
CPU Utilization | Percentage | CPU utilization by the Blockchain Platform |
NodesOcpuConsumption |
Nodes OCPU Consumption | OCPU | OCPU consumption by individual nodes in the Blockchain Platform |
StorageUtilization |
Storage Utilization | Percentage | The percentage of provisioned storage capacity in use |
CommitsProcessedByOrderer |
Commits Processed by Ordering Service | Count | Number of broadcast commits processed by the ordering service during the collection interval |
EndorsementsProcessedByPeer |
Endorsements Processed by Peer | Count | Number of endorsements processed by peer during the collection interval |
CommitsProcessedByPeer |
Commits Processed by Peer | Count | Number of commits processed by peer during the collection interval |
View Default Metric Charts in the Console
Default metric charts use predefined service queries. You can select resources of interest and update the interval, statistic, and time range.
To view default metric charts for all Blockchain Platforms in a compartment:
- Open the navigation menu. Under Observability & Management, go to Monitoring and click Service Metrics.
- For Compartment, select the compartment that contains the instances that you're interested in.
- For Metric Namespace, select oci_blockchainplatform. The Service Metrics page dynamically updates the page to show charts for each metric that is emitted by the selected metric namespace.
Optionally, you can specify other dimensions to filter your displayed metrics. For more information, see To filter results and To select different resources in the Oracle Cloud Infrastructure documentation.
For more information about monitoring and notifications in Oracle Cloud Infrastructure, see Monitoring Overview and Notifications Overview in the Oracle Cloud Infrastructure documentation.
To view default metric charts for a specific Blockchain Platform instance:
- Open the navigation menu. Under Developer Services, select Blockchain Platform.
- Select the compartment that contains the instance that you're interested in, and click that instance name from the list of instances.
- On the Instance page, under Resources, click Metrics. The default metrics for your instance will be displayed.
Create Metric Queries in the Console
To create a query for a customized view of your metrics:
-
Open the navigation menu. Under Observability & Management, go to Monitoring and click Metrics Explorer.
The Metrics Explorer page displays an empty chart with fields to build a query.
-
Fill in the fields for a new query.
For more information, see Building Metric Queries in the Oracle Cloud Infrastructure documentation.
View Metrics By Using the API
For information about using the API and signing requests, see REST APIs and Security Credentials in the Oracle Cloud Infrastructure documentation. For information about SDKs, see Software Development Kits and Command Line Interface.
Use the following APIs for monitoring:
- Monitoring API for metrics and alarms
- Notifications API for notifications (used with alarms)