Moogsoft Docs

Email

The Email integration allows you to retrieve email messages from one or more mail servers and send them to Moogsoft AIOps as events.

Refer to the Email LAM Reference to see the integration's default properties. When you use the integrations UI, you can only configure the visible properties.

If you want to implement a more complex Email LAM with custom settings, see Configure the Email LAM.

Before You Begin

Before you set up your Email integration, ensure you have met the following requirements for each mail source:

  • You know the details of the mail source:

    • Host name or IP address

    • Port

    • Username and password

    • Name of messages folder

  • You know the protocol used by your mail server: IMAP, IMAPS, POP3, or POP3S.

  • The port for your mail server is open and accessible from Moogsoft AIOps.

  • You know whether the body of the incoming email messages contain JSON.

  • If you are using the Email integration to connect to Gmail, you must configure the Gmail account to allow access for less secure apps. See the Google Help Center for more information.

Additionally, you can provide optional configuration details. See the Email LAM Reference and LAM and Integration Reference for a description of all properties.

Note

If your mail servers use SSL (POP3 or POP3S protocol) the integration looks for SSL keys and certificates with the default names and locations outlined in the Email LAM Reference. If your details are different, see Configure the Email LAM instead of using the integration.

Configure the Email Integration

To configure the Email integration:

  1. Navigate to the Integrations tab.

  2. Click Email in the Monitoring section.

  3. Provide a unique integration name. You can use the default name or customize the name according to your needs.

  4. Provide connection details for your mail system.

You do not need to perform any integration-specific steps on your email systems. After you configure the integration, it polls your mail servers at regular intervals to collect messages (every 60 seconds by default).