Monitoring Memory Usage and Availability for Provisioned Concurrency

To view the current memory limit for provisioned concurrency:

1. Open the navigation menu  and select Governance & Administration. Under Tenancy Management, select Limits, Quotas and Usage.

2. Select Functions from the Service list.

3. Select the region from the Scope list.

4. Select the root compartment from the Compartment list.

   The provisioned-concurrency-mb limit shows the current memory limit for provisioned concurrency.

5. (Optional) To request additional memory for provisioned concurrency, select the the Actions menu () beside the provisioned-concurrency-mb limit, select Open Support Request, and follow the instructions.

To view the amount of memory recently allocated for provisioned concurrency:

1. Open the navigation menu  and select Observability & Management. Under Monitoring, select Metrics Explorer.

2. Use the Start time and End time fields to specify a representative time period to analyze.
3. In the Query 1 panel, create a query as follows:
   1. For Compartment, select the root compartment.
   2. For Metric namespace, select oci_faas.
   3. Select the Advanced mode option and enter one of the following queries in the Query code editor:
      • To show the total amount of memory allocated for provisioned concurrency for all the functions in the tenancy at 5 minute intervals, during the time period you specified, enter the following query:

        AllocatedProvisionedConcurrency[5m].groupBy(resourceId).max().grouping().sum()

      • To show the total amount of memory allocated for provisioned concurrency for a specific function at 5 minute intervals, during the time period you specified, enter the following query:

        AllocatedProvisionedConcurrency[5m]{resourceId = "<function-OCID>"}.max()

        where <function-OCID> is the OCID of a function. For example:

        AllocatedProvisionedConcurrency[5m]{resourceId = "ocid1.fnfunc.oc1.phx.aaaa____uxoa"}.max()

4. Select Update Chart.

   The chart updates, and shows the amount of memory that was allocated for provisioned concurrency, during the time period you selected.

To create an alarm that fires when provisioned concurrency memory allocation exceeds a threshold that you define:

1. Open the navigation menu  and select Observability & Management. Under Monitoring, select Alarm Definitions.

2. Select Create Alarm.
3. For Alarm name, enter a meaningful name for the alarm. Avoid entering confidential information.
4. Select the Switch to Advanced Mode option.
5. In the Metric details area, specify the metric to evaluate for the alarm, as follows:
   1. For Compartment, select the root compartment.
   2. For Metric namespace, select oci_faas.
6. In the Trigger rule area, specify the condition that must be satisfied for the alarm to fire:
   • Trigger delay minutes: Enter the number of minutes that the condition must be maintained for the alarm to fire.
   • Alarm severity: Select the importance to be given to a notification that the alarm has fired.

   • Query code editor: Enter a query to define a condition that, when satisfied, causes the alarm to fire, as follows:

     • If you want the alarm to fire when memory allocation for provisioned concurrency exceeds a certain amount, enter the following query:

       AllocatedProvisionedConcurrency[5m].grouping().sum() > <memory-threshold>

       where <memory-threshold> is an amount of memory (in MiB) to use as the threshold, above which you want the alarm to fire.

       For example, you might want an alarm to fire when the amount of memory allocated for provisioned concurrency exceeds 70% of the total memory available for provisioned concurrency. If the total memory for provisioned concurrency is 40 GB (that is, 40,960 MiB), enter the following query:

       AllocatedProvisionedConcurrency[5m].grouping().sum() > 28672

     • If you want the alarm to fire when memory allocation for provisioned concurrency for a specific function exceeds a certain amount, enter the following query:

       AllocatedProvisionedConcurrency[5m]{resourceId = "<function-OCID>"}.max() > <memory-threshold>

       where:

       • <function-OCID> is the OCID of the function
       • <memory-threshold> is an amount of memory (in MiB) to use as the threshold, above which you want the alarm to fire.

       For example, you might want an alarm to fire when the amount of memory allocated for provisioned concurrency for a single function exceeds 10% of the total memory available for provisioned concurrency. If the total memory available for provisioned concurrency is 40 GB (that is, 40,960 MiB), enter the following query:

       AllocatedProvisionedConcurrency[5m]{resourceId = "ocid1.fnfunc.oc1.phx.aaaa____uxoa"}.max() > 4096

7. Select the Switch to Basic Mode option.
8. In the Define alarm notifications area:
   1. For Destination, specify where notifications are sent when the alarm fires:
      • Destination service: Select Notifications.
      • Compartment: Select the compartment that contains the resources that emit the metrics evaluated by the alarm. The selected compartment is also the storage location of the alarm.
      • Topic: The topic to use for notifications. Each topic supports one or more subscription protocols, such as PagerDuty. If a suitable topic does not already exist, select Create a topic and define a new topic. For reference, see Creating a Basic Alarm.
   2. For Message grouping, select one of the following options:
      • Group notifications across metric streams: Collectively track metric status across all metric streams. Send a message when metric status across all metric streams changes.
      • Split notifications per metric stream: Individually track metric status by metric stream. Send a message when metric status for each metric stream changes. For an example, see Scenario: Split Messages by Metric Stream.
   3. For Message Format, select one of the following options:
      • Send formatted messages: Simplified, user-friendly layout. To view supported subscription protocols and message types for formatted messages (options other than Raw), see Friendly formatting.
      • Send Pretty JSON messages (raw text with line breaks): JSON with new lines and indents.
      • Send raw messages: Raw JSON blob.
   4. To suppress evaluations and notifications for a specified length of time, select Suppress notifications. This option is useful for avoiding alarm notifications during system maintenance periods. Specify a start time, end time, and an optional description. See Best Practices for Your Alarms and Suppressing a Single Alarm.
   5. To save the alarm without starting to evaluate metric data, clear the Enable this alarm? check box.
9. Select Save alarm.