Contact Us 1-800-596-4880

Configure Alerting on Runtime Fabric

Runtime Fabric on VMs / Bare Metal enables you to send alerts through an existing SMTP server. Runtime Fabric on VMs / Bare Metal provides alert functionality to send notifications when system health is compromised.

Install rtfctl

The rtfctl utility is required to manage alert sender email on Runtime Fabric. Perform the steps in Install rtfctl before completing the following steps.

Procedure

  1. Using a terminal, open a shell/SSH connection to a controller VM.

  2. Create a file named alert-smtp.yaml that contains the following:

    kind: smtp
    version: v2
    metadata:
      name: smtp
    spec:
      host: <smtp host>
      port: <smtp port>
      username: <username>
      password: <password>
    ---
    kind: alerttarget
    version: v2
    metadata:
      name: email-alerts
    spec:
      email: <email>
  3. Modify the contents of alert-smtp.yaml using the following values specific to your environment:

    Table 1. Environment Variables
    Key Description

    <smtp host>

    The endpoint of the SMTP server.

    <smtp port>

    The port used to connect to the SMTP server. (465 by default).

    <username>

    The username to use when connecting to the SMTP server.

    <password>

    The password to use when connecting to the SMTP server.

    <email>

    The recipient email address.

  4. Run the following on the controller VM.

    $ sudo gravity resource create -f alert-smtp.yaml
  5. Use the rtfctl utility to set the alert sender email address containing your SMTP domain. Use a distinguishable email address for each cluster to identify the cluster triggering the alert.

    $ sudo ./rtfctl appliance apply alert-smtp-from "sender@example.com"

Alerts with the designated alert sender email address are now configured to be sent through your SMTP server.

Currently, only one alerts email recipient is supported.

Built-in Alerts

The following table lists some of default alerts provided by Anypoint Runtime Fabric on VMs / Bare Metal:

Table 2. Runtime Fabric Default Alerts
Alert Description

High CPU usage

Sends a warning when > 75% used. Triggers a critical error when > 90% used.

High memory usage

Sends a warning when > 80% used. Triggers a critical error when > 90% used.

High disk space usage

Sends a warning when > 80% used. Triggers a critical error when > 90% used.

High node usage

Sends a warning when > 90% used. Triggers a critical error when > 95% used.

etcd instance health

Sends an error when the etcd master is unaccessible for longer than 5 min.