Skip to content

Managing Alerts

You can configure alert notifications for SAP Business Technology Platform resources and mobile services using the SAP Alert Notification service. You can also subscribe to event and crash logs from SAP mobile service cockpit and configure alert notifications in the Alert Notification service.

To use the SAP Alert Notification service, you must enable the service and configure Subscriptions and Alerts. For example, you could create conditions to receive notifications for one or more applications, or for release upgrades. The notifications can be consumed using email, Slack, and other channels.

From SAP mobile service cockpit, you can subscribe to event and crash logs, and create a condition in the Alert Notification service to receive alert notifications. Use My Alerts to manage event and crash log subscriptions, and view release notes.

Subscribe to Mobile Services Alerts

Use the SAP Alert Notification service for SAP Business Technology Platform to receive notifications about mobile services alerts.

Users must enable the Alert Notification service, and configure Subscriptions and Alerts (subscriptions and alerts cannot be managed through SAP mobile service cockpit).

Alerts must be enabled, and alert levels must be configured for the application.

The Alert Notification service enables users to receive and create custom alerts and notifications for SAP Business Technology Platform resources, and consume them using the system of their choice such as email, Slack, and other channels. See SAP Alert Notification service for SAP Business Technology Platform for information about the service.

  1. (Users) To receive notifications, create a condition in the Alert Notification service in the same space:

    Key: tags.mobile_alert_app
Predicate: Is Equal To
Value: appId

  2. (Users) To receive alerts for all applications, create a condition:

    Key: eventType
Predicate: Is Equal To
Value: MobileServicesApplicationAlert

Subscribe to Release Upgrade Notices

Use the SAP Alert Notification service for SAP Business Technology Platform to receive notifications when a new version of mobile services is available.

Users must enable the Alert Notification service, and configure Subscriptions and Alerts (subscriptions and alerts cannot be managed through SAP mobile service cockpit).

The Alert Notification service enables users to receive and create custom alerts and notifications for SAP Business Technology Platform resources, and consume them using the system of their choice such as email, Slack, and other channels. See SAP Alert Notification service for SAP Business Technology Platform for information about the service.

(Users) When setting up the subscription, you'll need the following condition configuration information:

1
2
3
4
5
``` text
Key: eventType
Predicate: Is Equal To
Value: MobileServicesReleaseNotice
```

To learn more: Configuration Management Using the SAP Business Technology Platform Cockpit.

Subscribe to Crash Log Notices

Use the SAP Alert Notification service to receive ongoing mobile services crash log notifications.

You must subscribe to a crash log in SAP mobile service cockpit as described in Subscribe to Crash Alerts. When you create the subscription and enable the ANS checkbox, you receive Alert Notification information to help you create a condition in the Alert Notification service.

Create a condition for the subscription via the SAP Business Technology Platform Alert Notification service, and you can continue to receive alert notifications for three months. See SAP Alert Notification service for SAP Business Technology Platform for information about the service.

You can extend the subscription for another three months using My Alerts. See Managing My Alerts.

  1. (Users) To receive notifications on crash log type subscription, create a condition in the Alert Notification service in the same space:

    Key: tags.mobile_crash_log_alert
Predicate: Is Equal To
Value: subscription_name

  2. (Users) To receive notifications for all crash log subscriptions, create a condition in the Alert Notification service in the same space:

    Key: eventType
Predicate: Is Equal To
Value: MobileServicesCrashLogAlert

Subscribe to Event Log Notices

Use the SAP Alert Notification service to receive ongoing mobile services event log notifications.

You must subscribe to an event log in SAP mobile service cockpit as described in Subscribe to Event Log Alerts. When you create the subscription and enable the ANS checkbox, you receive Alert Notification information to help you create a condition in the Alert Notification service.

Create a condition for the subscription via the SAP Business Technology Platform Alert Notification service, and you can continue to receive alert notifications for three months. See SAP Alert Notification service for SAP Business Technology Platform for information about the service.

You can extend the subscription for another three months using My Alerts. See Managing My Alerts.

  1. (Users) To receive notifications for event log type subscriptions, create a condition in the Alert Notification service in the same space:

    Key: tags.mobile_event_log_alert
Predicate: Is Equal To
Value: subscription_name

  2. (Users) To receive notifications for all event log subscriptions, create a condition in the Alert Notification service in the same space:

    Key: eventType
Predicate: Is Equal To
Value: MobileServicesEventLogAlert

Subscribe to Certificate Expiration Notices

You can create certificate expiration alerts for several certificates used with Mobile Services, and use the SAP Alert Notification service (ANS) to receive notifications about the alerts. See SAP Alert Notification service for SAP BTP for information about the service.

Before receiving certificate expiration alerts, you must:

  1. In the SAP Business Technology Platform cockpit, configure the ANS service in the provider for the selected application. For example, enable the ANS service for service-instance-service. Navigate to mobiledev > provider > int-test > Applications > service-instance-service > mobiledev > provider > int-test.

  2. Add the following Key and Value in User-Provided Variables:

    Key:
FRAMEWORK_ALERT_NOTIFICATION_KEY_CREDENTIALS

Value:
{
    "client_id": "e49ba8d1-0a53-4729-97f5-80da6569bc1c",
    "client_secret": "YAugmRMo2h5ljXBoyVlJXS2ScLgrp60e",
    "url": "https://clm-sl-ans-canary-ans-service-api.cfapps.sap.hana.ondemand.com"
}

You can define certificates expiration alerts for these conditions:

  • Push Apple Push Notification service (APNS) configuration with X509 certificate.

  • Service key of service with X509 certificate, for example, service key of push, service key of mobile connectivity.

  • Connectivity destination configured with key store and trust store.

When configured, you will receive certificate alerts for Push APNS, Service Key, and Connectivity Destination when:

  • The valid date of certificate is within 30 days of expiring.

  • The certificate has already expired.

To configure alerts and notifications:

  1. Add an Alert Notification Instance in the space of mobile application to receive alert message. Add an alert subscription and set the condition to eventType isEqualsTo MobileServicesCertificateExpiration.

    For example:

    mobiledev > mobile-tenantx > Services > Service Marketplace > Alert Notification > click menu: Instances and Subscriptions > add instance: alert-notification-integration-test-ins

    In the Alert Notification instance, click Subscriptions and create the subscription and the condition for eventType isEqualsTo MobileServicesCertificateExpiration.

  2. Create the mobile application to configure X509 certificates in Push APNS, Connectivity Destination and Service Key.

    For example:

    app > Mobile Push Notification > Configuration > Apple > Authentication > Certificate

    app > Mobile Push Notification > Service Keys > Add Service Key, Type: X.509

    Mobile Connectivity > Configuration > add Configuration > upload keystore,truststore

    Mobile Connectivity > Service Keys > Add Service Key, Type: X.509

  3. The sample message of certificate expiration alert for service key:

    Landscape Details:
    region: cf-eu10-canary
    region type: sap-cp

Resource Details:
    global account: mobiledev
    subaccount: d9d8680d-95c8-406e-8e6d-fa16de8faa39
    resource group: d8204f1e-7751-499b-9d05-d74c9de77c65
    resource type: SAP Mobile Services
    resource name: certExpirationAlert

Resource Tags:
    globalAccountId: mobiledev
    organizationId: d9d8680d-95c8-406e-8e6d-fa16de8faa39
    resourceLandscape: cf-eu10-canary
    spaceId: d8204f1e-7751-499b-9d05-d74c9de77c65
    subAccountId: 4a79476a-b15d-4305-8cde-9378a46b5b69

Event Details:
    event type: MobileServicesCertificateExpiration
    event subject: Certificate will expire soon
    event timestamp: 1712970000 [ 2024-04-13T01:00:00Z ]
    category: ALERT
    severity: WARNING

Event Tags:
    ans:eventScope: CF_SPACE
    ms_app: certExpirationAlert
    ms_service: service-proxy

Event Body:
Subaccount ID:4a79476a-b15d-4305-8cde-9378a46b5b69
Subdomain:mobile-tenant3
Application ID:certExpirationAlert
Service name: service-proxy
Service key alias: certExpireServiceKey
The certificate will be expired at Tue Apr 16 06:58:56 UTC 2024

  4. The sample message of certificate expiration alert for connectivity destination:

    Landscape Details:
    region: cf-eu10-canary
    rgion type: sap-cp

Resource Details:
    global account: mobiledev
    subaccount: d9d8680d-95c8-406e-8e6d-fa16de8faa39
    resource group: d8204f1e-7751-499b-9d05-d74c9de77c65
    resource type: SAP Mobile Services
    resource name: testCertAlert

Resource Tags:
    globalAccountId: mobiledev
    organizationId: d9d8680d-95c8-406e-8e6d-fa16de8faa39
    resourceLandscape: cf-eu10-canary
    spaceId: d8204f1e-7751-499b-9d05-d74c9de77c65
    subAccountId: 4a79476a-b15d-4305-8cde-9378a46b5b69

Event Details:
    event type: MobileServicesCertificateExpiration
    event subject: Certificate will expire soon
    event timestamp: 1713500110 [ 2024-04-19T04:15:10Z ]
    category: ALERT
    severity: WARNING

Event Tags:
    ans:eventScope: CF_SPACE
    ms_app: testCertAlert
    ms_service: service-proxy

Event Body:
Subaccount ID:4a79476a-b15d-4305-8cde-9378a46b5b69
Subdomain:mobile-tenant3
Application ID:testCertAlert
Service name: service-proxy
Endpoint name: testCertAlert
Endpoint certificate alias: smp_crt
The certificate of alias smp_crt in keystore has already expired at Wed Jul 01 16:21:55 UTC 2015
The certificate of alias tc_trust_center_ssl_ca_1 in truststore has already expired at Thu Feb 14 17:45:15 UTC 2013
The certificate of alias entrustserverca in truststore has already expired at Sat May 25 16:39:40 UTC 2019
The certificate of alias telekomonlinepass in truststore has already expired at Tue Jul 09 23:59:00 UTC 2019
The certificate of alias thawteserverbasic in truststore has already expired at Thu Dec 31 23:59:59 UTC 2020
The certificate of alias tctrustcenterclass2 in truststore has already expired at Sat Jan 01 11:59:59 UTC 2011
The certificate of alias equifax_secure_certificate_authority in truststore has already expired at Wed Aug 22 16:41:51 UTC 2018
The certificate of alias tctrustcenterclass1 in truststore has already expired at Sat Jan 01 11:59:59 UTC 2011
The certificate of alias entrustpersonalserverca in truststore has already expired at Sat Oct 12 19:54:30 UTC 2019
The certificate of alias mykey in truststore has already expired at Thu Aug 31 12:00:00 UTC 2023
The certificate of alias gte_global_root in truststore has already expired at Mon Aug 13 23:59:00 UTC 2018
The certificate of alias sappassportca in truststore has already expired at Sat Jul 18 10:00:00 UTC 2015
The certificate of alias smp_crt in truststore has already expired at Wed Jul 01 16:21:55 UTC 2015

  5. The sample message of certificate expiration alert for Push APNS Endpoint:

    Landscape Details:
    region: cf-eu10-canary
    region type: sap-cp

Resource Details:
    global account: mobiledev
    subaccount: d5c92d6a-71f8-433b-9229-25a8fea913ad
    resource group: 80888875-d3b7-4d00-b937-9b1640886385
    resource type: SAP Mobile Services
    resource name: piat.custom.basic.scc

Resource Tags:
    globalAccountId: mobiledev
    organizationId: d5c92d6a-71f8-433b-9229-25a8fea913ad
    organizationName: mobiledev_cmk-ops-subscriber
    resourceLandscape: cf-eu10-canary
    spaceId: 80888875-d3b7-4d00-b937-9b1640886385
    spaceName: stg
    subAccountId: 95dc8f00-2615-45bc-abaf-3a8474294e90

Event Details:
    event type: MobileServicesCertificateExpiration
    event subject: Certificate will expire soon
    event timestamp: 1713229203 [ 2024-04-16T01:00:03Z ]
    category: ALERT
    severity: WARNING

Event Tags:
    ans:eventScope: CF_SPACE
    ms_app: piat.custom.basic.scc
    ms_service: service-push

Event Body:
Application ID:piat.custom.basic.scc
Subaccount ID:95dc8f00-2615-45bc-abaf-3a8474294e90
Subdomain:cmk-ops-subscriber
Organization Name:mobiledev_cmk-ops-subscriber
Space Name:stg
Global account ID:mobiledev
The certificate: PIATBJPush2023.p12 of APNS Endpoint: SANDBOX has already expired at Thu Dec 28 06:55:48 UTC 2023

Managing My Alerts

Use the SAP mobile service cockpit My Alerts option to manage mobile services subscriptions to event or crash log events at the tenant level, and to access release notes. You can create conditions in SAP SAP Business Technology Platform Alert Notification service to receive ongoing notifications for these alerts.

You must enable the Alert Notification service and configure Subscriptions and Alerts to receive ongoing alert notifications for event and crash logs. For convenience, the format for the alert condition is provided when you subscribe to an event or crash logs.

  1. In SAP mobile service cockpit, select My Alerts.

  2. You can narrow the focus of events to view by setting filters, such as Time Frame and Category (server side search); and Send to ANS and subscription name (local search). You can also select Filter out 0 Message Subscriptions to filter out message subscriptions without message titles, to clean up the view (local search). Select Go to start the search, and Reset Filter to clear your filter entries.

    A list of events appears based on the filters selected. Any row with a blue highlight to the left indicates that new or unread message were received since the subscription was last viewed.

    My Events

    Column Description
    Latest Message Time (UTC) The time of the last message received for the subscription.
    Count The total count of messages received for the subscription in the time frame selected.
    Category The event category for the subscription, including Event Log, Crash Log, Release Note, or All.
    Latest Message Title The latest message title received for the subscription.
    Subscription Name The subscription name assigned to an event.
    Send to ANS Whether to send the event to the Alert Notification service.
    ANS Expires (UTC) Identifies when the Alert Notification service subscription expires.
    Actions Actions you can take such as edit, delete, or extend the subscription. If a subscription is a month from expiration, you can extend it another three months. The new date is reflected in the ANS Expires column.

  3. Select a row to see details.

  4. Select an Event Log row to open the log in Analytics > Logs, with your filters set. You can subscribe to the event, or view details. See Subscribe to Event Log Alerts to learn more.

  5. Select a Crash Log row to open the log in Analytics > Crashes, with your filters set. You can subscribe to the event, or view details. See Subscribe to Crash Alerts to learn more.

  6. Select a Release Note row to open the Release Note page for a release note version. The Release Note Overview provides links to information.

Last update: April 26, 2024