Create a Monitor
To set up the Synthetic Monitoring feature, you must create a monitor to monitor the availability and performance of your application across geographical locations and send metrics to Oracle Cloud Infrastructure.
If you want to create the Scripted Browser and Scripted REST monitor types, you must ensure that you've created a script. For information, see Create a Script.
To create a monitor:
- Navigate to the Synthetic Monitoring page.
- On the left pane, ensure that Monitors is selected.
- On the left pane, select the compartment and the APM domain in which you want to create the monitor.
- Click Create Monitor.The Create Monitor wizard is displayed.
- On the Monitor Definition page:
- Name: Enter a unique name for the
monitor.
The name can have a maximum of 255 alphanumeric characters. A hyphen and an underscore are the only two special characters allowed. For example, you can add a hyphen between two characters and an underscore at the beginning or the end of the name or between characters. Blank spaces are not allowed.
- Type: Select one of the following
monitor types:
- Browser: Tests the performance of a single URL loaded by a browser.
- Scripted Browser: Tests the
performance of a complete user transaction workflow recorded in
a
.side
script file. - REST: Tests the performance of a single URL loaded by a REST call.
- Scripted REST: Tests the
performance of a complete user transaction workflow recorded in
a
.js
script file.
- Update the fields displayed based on the monitor type
selected in the previous step:
- For the Browser monitor
type:
- Base URL: Specify the base URL on which to run the monitor.
- Verify Response Content Optional: Optionally, add a string to verify expected response content.
- Options: Optionally,
select the following check boxes:
- Verify SSL: Select this option to verify the validity of the SSL certificate.
- Override DNS: Select this option to specify the IP address to which the target's domain name will resolve, instead of using the standard DNS resolution.
- For the Scripted Browser
monitor type:
- Script: Select a
script file from the drop-down list, which is populated
with the names of the
.side
scripts you've created. - Base URL
Optional: Based on the selected
.side
script file, this field is populated with the base URL on which the monitor is to be run. Optionally, you can also specify the base URL in this field. - Script Parameters: If script parameters are defined in the contents of the script file, then they are displayed in the Script Parameter fields and you can choose to replace the parameter values. Note that the parameter value is not displayed if the Value is secret option is used when creating or uploading the script.
- Options: Optionally,
select the following check boxes:
- Verify SSL: Select this option to verify the validity of the SSL certificate.
- Override DNS: Select this option to specify the IP address to which the target's domain name will resolve, instead of using the standard DNS resolution.
- Script: Select a
script file from the drop-down list, which is populated
with the names of the
- For the REST monitor type:
- Base URL: Specify the base URL on which to run the monitor.
- Request Configuration
Method: Select a request configuration
method:
GET
orPOST
. For thePOST
method, you can optionally enter the request payload information in the Request Body field. - Authentication Type:
Select a type of authentication:
- None: Select this option if no authentication is required.
- Basic Auth: Select this option if basic authentication is required and specify the User Name and Password.
- Bearer Token: Select this option if bearer authentication is required and specify the Token.
- OAuth: Select this option if open authentication is required and specify the Authentication Scheme and information in the fields that are displayed based on the authentication scheme.
- Query Parameters Optional: Optionally, specify the request configuration query parameters.
- Header Parameters Optional: Optionally, specify the request configuration header parameters.
- Response Validations:
Optionally, select:
- Response Code
and specify valid HTTP status codes such as
200
and401
. - Verify Response Content to add a string or REGEX to verify expected response in response headers and body.
- Response Code
and specify valid HTTP status codes such as
- Options: Optionally,
select the following check boxes:
- Verify SSL: Select this option to verify the validity of the SSL certificate.
- Follow Redirects: Select this option to follow redirects.
- Override DNS: Select this option to specify the IP address to which the target's domain name will resolve, instead of using the standard DNS resolution.
- For the Scripted REST
monitor types:
- Script: Select a
script file from the drop-down list, which is populated
with the names of the
.js
scripts you've created. - Base URL
Optional: Based on the selected
.js
script file, this field is populated with the base URL on which the monitor is to be run. Optionally, you can also specify the base URL in this field. - Script Parameters: If script parameters are defined in the contents of the script file, then they are displayed in the Script Parameter fields and you can choose to replace the parameter values. Note that the parameter value is not displayed if the Value is secret option is used when creating or uploading the script.
- Options: Optionally,
select the following check box:
- Override DNS: Select this option to specify the IP address to which the target's domain name will resolve, instead of using the standard DNS resolution.
- Script: Select a
script file from the drop-down list, which is populated
with the names of the
- For the Browser monitor
type:
Click Next.
- Name: Enter a unique name for the
monitor.
- On the Run Settings page:
- Vantage Points: Select the vantage points on which you want the monitor to run. If you've set up a Dedicated Vantage Point, then it is also listed in the drop-down list and can be selected. For information on Dedicated Vantage Points, see Use Dedicated Vantage Points.
- Select one of the following radio buttons to determine the
frequency of monitor runs:
- Interval: Select this radio button to determine the interval of time between each monitor run.
- Run Once: Select this radio button if you want the monitor to run only once. If the Run Once radio button is selected, the Scheduling Policy drop-down list and the Interval Between Runs (minutes) field are disabled.
- Scheduling Policy: Select one of the
following options to stagger the monitor runs on the selected vantage
points:
- All: Select this option to run the monitor simultaneously on all selected vantage points.
- Round Robin: Select this option to schedule the monitor run sequentially on each vantage point. This functionality works in tandem with the value specified in the Interval Between Runs (minutes) field. For example, if 10 minutes is specified in the Interval Between Runs (minutes) field and the monitor is to run on five vantage points, then the monitor will run on the vantage points sequentially with an interval of ten minutes between each run. The total duration of the monitor runs on all vantage points will then be 50 minutes, after which the sequential monitor run will begin again.
- Batched Round Robin: Select
this option to schedule the monitor run sequentially on batches
of vantage points. This functionality works in tandem with the
values specified in the Interval Between Runs
(minutes) and Sub-interval Between
Runs (minutes) fields. In this scenario,
monitors are scheduled to run on batches of vantage points and
the interval between each run is specified in the
Sub-interval Between Runs (minutes)
field. The value in the Interval Between Runs
(minutes) field denotes the total time taken for
the monitor run on all batches.
The number of vantage points in each batch is automatically calculated based on the number of selected vantage points and the values specified in the Interval Between Runs (minutes) and Sub-interval Between Runs (minutes) fields. For example, if there are 7 vantage points, Interval Between Runs (minutes) = 10 minutes, and Sub-interval Between Runs (minutes) = 5 minutes, then two batches are created. The first batch of vantage points will have four vantage points and the second batch will have three.
- Interval Between Runs (minutes):
Specify the number of minutes between monitor runs. The default interval
duration is 10 minutes. For the REST monitor
type, you can specify one minute as the minimum duration of the interval
between monitor runs, and for the other monitor types, you can specify
five minutes as the minimum duration.
Note that if the Batched Round Robin option is selected in the Scheduling Policy drop-down list, then the value selected in the Interval Between Runs (minutes) field denotes the total time taken for the monitor run on all batches.
- Sub-interval Between Runs (minutes): Specify the number of minutes between monitor runs on batches of vantage points. Note that this field is only displayed if the Batched Round Robin option is selected in the Scheduling Policy drop-down list.
- Timeout (minutes): Specify the timeout value. This denotes the maximum runtime allowed and if the monitor runtime does not complete within this time, it will be stopped and marked as a failure. Note that the Interval Between Runs value must be about three times more than the Timeout (minutes) value, however, if the Enable Retry check box is not selected, then the Timeout (minutes) value can be set to 50% of the Interval Between Runs value.
- Enable Retry: Select this check box to retry execution in case of failure. Note that this check box is selected by default.
- Enable Network Collection: Select
this check box to enable data collection from the network and monitor
network performance. Note that for a Scripted
REST monitor, this check box is only displayed if the
Base URL is specified on the
Monitor Definition page:
On selecting the Enable Network Collection check box, the following options are displayed:
- Protocol: Select a network protocol.
- Probe Mode: Select a probe mode for the TCP network protocol. Note that the Probe Mode option is only available for the TCP network protocol.
- Probe Per Hop: Specify the number of probe packets sent per hop.
Click Next.
- On the Availability Configuration (Optional) page, you
can select the Enable Availability Configuration check
box to configure the criteria to calculate the availability of the monitor and
view the corresponding details in the Availability widget
in the Oracle-defined Monitors dashboard.
On selecting the Enable Availability Configuration check box, the following options are displayed:
- Maximum failures allowed per interval: Specify the maximum number of failed monitor runs allowed in an interval. An interval with more than the specified number of failed monitor runs will be classified as UNAVAILABLE.
- Minimum runs allowed per interval: Specify the minimum number of monitor runs allowed in an interval. An interval with less than the specified number of monitor runs will be classified as UNKNOWN and excluded from the availability calculations.
Click Next.
For information on viewing the availability of the monitor in the Monitors dashboard, see View Monitor Availability.
- On the Tags (Optional) page, you can choose to use the
Tagging metadata system to organize and track the monitors, and click
Next.In the Tag namespace drop-down list, you can select a namespace that is prefixed with
apm-synthetics
and add a maximum of five Tag keys and Tag values. These key – value pairs will then be added as dimensions and can be used as additional qualifiers for Synthetic Monitoring metrics (oracle_apm_synthetics
namespace). This enables you to monitor other aspects of the monitor and organize and track monitors using an APM-specific tag.Note
The Tag key name cannot be the same as an existing dimension. You can create any tag namespace but only namespaces that have theapm-synthetics
prefix will be picked up and published to the Oracle Cloud Infrastructure Monitoring service as a dimension.For information on:
- Synthetic Monitoring dimensions and metrics, see Available Metrics: oracle_apm_synthetics.
- Tagging, see Tagging Overview.
- On the Summary page, review the summary of the monitor, and click Create.
You can also use the options available on the top of the page to perform the following actions on the monitor:
- Edit: Click to edit monitor information.
- Clone: Click to clone the monitor.
- Disable: Click to disable the monitor.
- Run Now or Run Once:
Click Run Now to run the monitor immediately. This option
is only displayed for monitors that have scheduled monitor runs and is not
displayed if the Run Once option was selected when
creating the monitor. If you select the Run Now option, a
new instance of the monitor is created and is executed just once. This does not
impact the existing monitor run schedule, and for the Run
Now mode, a separate set of results is listed in a new row on
the Monitors page.
Click Run Once to run the monitor. This option is only displayed if the Run Once check box was selected when creating the monitor.
Click More actions to perform the following tasks:
- Enable maintenance window: Click to enable a maintenance window for the monitor.
- Add Tags: Click to add tags to the monitor.
- Delete: Click to delete the monitor.
On navigating to the Monitors page, you'll find the newly created monitor listed. You can select one or more monitors and click Actions and then select Manage maintenance window to enable or disable a maintenance window. For more information, see Manage Maintenance Windows.