Configuring email destinations

Before your connections can successfully send data to a destination, your Tanium as a Service instance must be configured. Contact Tanium Support with the destination URL or IP and service port to submit a request.

For more information, see Tanium as a Service Deployment Guide: Proxy access.

You can send information from a connection source to a set of email addresses. You can either include the results in the email body, or create an attachment.


  • Email addresses for sending and receiving email results.
  • Information about your mail server, including host, port, user name, password, and authentication information.

Specify general connection information

  1. On the Connect Overview page, scroll to the Connections section and click Create Connection.
  2. Enter a name and description for the connection.
  3. (Optional) In the General Information section, expand Advanced to configure the following settings:

    Log Level

    By default, the logging is set to Information. Set the log level to Trace or Debug if you are debugging the connection. To reduce the amount of logging, you can set the log level to Warning, Error, or Fatal.

    By default, the logging is set to Information. Set the log level to Trace or Debug if you are debugging the connection. To reduce the amount of logging, you can set the log level to Warning, Error, or Fatal.

    Minimum Pass Percentage

    Minimum percentage of the expected rows that must be processed for the connection to succeed.

    Memory Ceiling (GB)

    Maximum memory for the node process to run the connection.

Configure the connection source

The connection source determines what data you are sending to the destination. This data is usually information from Tanium, such as a saved question, question log, client status, or event. The settings vary depending on which source you choose.

Configure the email results destination

  1. In the Email section for the destination, provide a name for the destination.
    • You can specify a unique name to save the configuration information as a new destination, or select an existing email destination from the list.
    • If you edit the settings for an existing destination, all connections that use that destination are affected.
    • To clone an existing destination, select the existing destination and change the name.
  2. In the Email section, provide information about the email subject, to address, and from address sections. Some fields also support variable substitution, as listed in Reference: Variables.
  3. Specify information about the mail server in the Mail Configuration section:
    • Provide the host name, port, user name, and password.
    • Select Secure if the connection with the SMTP server is authenticated and uses TLS encryption.
    • Specify a Timeout value for sending the message. The default is 0, which means that there is no timeout. A recommended timeout value is 10 seconds.
  4. (Optional) Specify advanced settings. Some fields also support variable substitution, as listed in Reference: Variables.
    • You can configure CC and BCC addresses for the email and specify the settings for the email attachment.
    • If you specify an Attachment File Name, include a file extension with the file name. The file extension does not need to match the format option you select in the Format section. Note the option that you select in the Format section does not add or change the file extension.
    • You can compress the attachment into a zip or gzip file. If you select a compression method, the file extension for the compression method is automatically added to the end of the file name.

Configure filters

(Optional) In the Configure Output > Filters section, you can specify filters to modify the data that you are getting from your connection source before it is sent to the destination.

For more information about the types of filters you can configure, see Reference: Filtering options.

Format data for email

You can choose from any of the available formats for your email. The data is sent in the body of the email by default.

If you want to attach a file to the email instead of having the data in the body of the email, edit the Advanced settings for the Email destination and select Attachment. Specify a file name and whether the file should be compressed.

The data format for email destinations is HTML by default. You can choose the columns that are displayed in the resulting email.

In the Configure Output > Columns section, you can change the Destination Label of each column and Value Type to force the column to be a String, Numeric, or Date/Time value.

If you choose Numeric for the value, you can specify a default value that is used if the data cannot be coerced into a numeric value. You can specify any negative or positive number.

If you choose Date/Time for the value, specify the format that you want to use for the column. For more information about using a variable, see Time stamp variables.

Schedule the connection

Connections can run at a highly configurable time interval, such as multiple times per hour, day, week, or month.

If you do not enable the schedule, the connection only runs when you manually run it.

Use the Schedule section to update the schedule:

  • Select Enable schedule.
  • In the Schedule Type, select Basic to build a schedule with the provided controls.
  • To view or edit the Cron expression directly, select Advanced - Define as a Cron Expression, and use the Advanced field to edit the Cron expression.

If a user that owns a scheduled connection is deleted, future scheduled instances of that connection do not run. For more information, see Problem: Scheduled connection owned by a deleted user no longer runs.

For more information about Cron syntax, see Reference: Cron syntax.

Save and verify connection

  1. After you enter the details for the connection, click Save.

    To save the connection and immediately run the connection, click Run and Save.

    If needed, resolve any errors or missing information. After the connection creates successfully, the connection details display.

  2. To view details when the connection runs, click the Logs tab.
  3. To view an individual run log, expand the row table.