Troubleshooting Notifications

This topic covers troubleshooting techniques for Notifications.

Message not received

Tip

Assess alarms and messages using their unique identifiers. See Prevent Processing of Duplicate Items. To view the format used by alarm messages, see Message format and examples.

Check these items: 

  • Alarm firing transition: If the message is a result of a firing alarm, then view the history of the alarm. Note times for any transition to a firing state. You'll use noted times for comparison to metrics for your topic ("Publication and delivery").

    To view history for your alarm
    1. Open the navigation menu. Under Solutions and Platform, go to Monitoring and click Alarm Definitions.
    2. On the Alarm Definitions page, click the alarm that you want to view history for.
    3. Adjust the time range by selecting from Quick Selects or changing the Start Time and End Time.
  • Publication and delivery: Note times for messages published to your topic as well as messages delivered to your topic. Compare to times of the firing alarm or other inciting incident.

    To view timing of published and delivered messages for your topic
    1. Open the navigation menu. Under Solutions and Platform, go to Application Integration and click Notifications.
    2. Choose the Compartment that contains your topic, and then click the topic's name.
    3. In the Resources menu, click Metrics.

      The Metrics page displays a chart for each metric that is emitted by the metric namespace for Notifications. For more information about the emitted metrics, see Available Metrics: oci_notification.

    4. Adjust the time range by selecting from Quick Selects or changing the Start Time and End Time.
    5. Review the following metric charts: 
      • Published Messages Total Count
      • Delivered Messages Count

Function not invoked or run

This section provides troubleshooting information for function subscriptions. For an example function subscription, see Scenario A: Automatically Resize VMs.

Note

The Notifications service has no information about a function after it's invoked.
Tip

Assess alarms and messages using their unique identifiers. See Prevent Processing of Duplicate Items. To view the format used by alarm messages, see Message format and examples.

Check these items: 

  • Message receipt: See Message not received.
  • Function invocation: Note times for invocations of your function. Compare to times of the firing alarm or other inciting incident.

    Note

    If this is the first invocation, response may be delayed.
    To view timing of invocations for your function
    1. Open the detail page for your function by doing one of the following.
      • Find your function on the related subscription page:
        1. Open the navigation menu. Under Solutions and Platform, go to Application Integration and click Notifications.
        2. Choose the Compartment that contains your function subscription.
        3. Click Subscriptions.
        4. Under Endpoint, in the row for your function subscription, click the name of your function.
      • Find your function on a Functions page: 
        1. In the Console, open the navigation menu. Under Solutions and Platform, go to Developer Services and click Functions.
        2. Select the region you are using with Oracle Functions. Oracle recommends that you use the same region as the Docker registry that's specified in the Fn Project CLI context (see 6. Create an Fn Project CLI Context to Connect to Oracle Cloud Infrastructure).
        3. Select the compartment containing the application that contains your function.

          The Applications page shows all the applications in the compartment you selected.

        4. Click the name of the application containing your function.
        5. Click the name of your function.

      The function detail page is displayed.

    2. Under Resources, click Metrics.

      The Metrics page displays a chart for each metric that is emitted by the metric namespace for Oracle Functions. For more information about the emitted metrics, see Available Metrics: oci_faas.

    3. Adjust the time range by selecting from Quick Selects or changing the Start Time and End Time.
    4. Review the Invocations chart.
  • Function run: Note times for runs of your function. Compare to times of the firing alarm or other inciting incident.

    To view timing of runs of your function (metrics)
    1. Open the detail page for your function by doing one of the following.
      • Find your function on a subscription page:
        1. Open the navigation menu. Under Solutions and Platform, go to Application Integration and click Notifications.
        2. Choose the Compartment that contains your function subscription.
        3. Click Subscriptions.
        4. Under Endpoint, in the row for your function subscription, click the name of your function.
      • Find your function on a Functions page: 
        1. In the Console, open the navigation menu. Under Solutions and Platform, go to Developer Services and click Functions.
        2. Select the region you are using with Oracle Functions. Oracle recommends that you use the same region as the Docker registry that's specified in the Fn Project CLI context (see 6. Create an Fn Project CLI Context to Connect to Oracle Cloud Infrastructure).
        3. Select the compartment containing the application that contains your function.

          The Applications page shows all the applications in the compartment you selected.

        4. Click the name of the application containing your function.
        5. Click the name of your function.

      The function detail page is displayed.

    2. Under Resources, click Metrics.

      The Metrics page displays a chart for each metric that is emitted by the metric namespace for Oracle Functions. For more information about the emitted metrics, see Available Metrics: oci_faas.

    3. Adjust the time range by selecting from Quick Selects or changing the Start Time and End Time.
    4. Review the Duration chart.