FortiTelemetry Windows software agent

This topic covers administration of the Windows OS based FortiTelemetry endpoint agent, and includes the following sections:

• Prerequisite configurations on the Windows host

• Installing the agent

• Managing the agent in Windows

• Using the FortiTelemetry Windows agent GUI

• Viewing agent logs

Prerequisite configurations on the Windows host

The following steps need to be taken on the Windows host for successful functioning of the FortiTelemetry agent. The example in this document uses Windows 10 (64-bit).

To configure the Windows host:

1. Configure Power & Sleep settings:

   1. On the Windows system, search and navigate to System Settings > Power & Sleep settings.

   2. Change the time for Sleep to Never.
      

2. Configure network port management settings:

   1. Go to Windows Settings > Network & Internet > Ethernet > Change adapter options.
      The list of network adapters on the host is displayed.

   2. Right-click on the network adapter connecting to the FortiTelemetry Controller (FortiGate) and click on Properties.
      

   3. Click on the Configure button under Networking.
      

   4. Click on the Power Management tab, and uncheck the Allow the computer to turn off this device to save power setting.
      

3. Configure the FortiGate acting as FortiTelemetry Controller with a CA and install the certificate to the FortiTelemetry Windows agent. See Configure the certificate (for FortiTelemetry Windows agent only).

Installing the agent

To install the FortiTelemetry Windows agent:

1. Copy the FortiTelemetry agent installer (.msi) file on the Windows host system.

2. Run the installer by double-clicking or right-click > Install. This will start the FortiTelemetry Agent Setup Wizard.

3. Click Next, review and accept the License Agreement, and click Next again.

4. Configure the installation path and click Next.

5. Click Install. This will install the FortiTelemetry agent.

6. Click Finish to complete the installation.

Managing the agent in Windows

You can use the Windows Task Manager to check the status of the FortiTelemetry agent processes, as in the example below.

The FortiTelemetry agent daemon will automatically run after installation or on restarting the Windows system. You can use the Services app on the Windows system to Start, Stop, Pause and Resume the FortiTelemetry Daemon service as shown in the example below.

Using the FortiTelemetry Windows agent GUI

The FortiTelemetry Windows agent has two components: The graphical user interface (GUI) and the backend daemon.

The GUI includes 3 tabs which display different information about the FortiTelemetry Windows agent and allows you to make selections for configuration. These tabs include Monitors, Settings, and About.

Monitor

When the connection between the FortiTelemetry Windows agent and the FortiTelemetry Controller is successful, and the correct configuration for application monitoring is present on the FortiGate, the FortiGate will send monitoring tasks to the agent. The details of the current monitoring tasks on the agent can be seen from the Monitor tab.

Settings

The Settings tab allows you to configure certain settings for the FortiTelemetry Windows Agent, including:

Network Interface	Configure the interface to use while connecting to the FortiTelemetry Controller (FortiGate). By default, the interface with the default gateway will be chosen, but you can select any other interface that you prefer.
Agent Management Certificate	Select the certificate for the agent to use while negotiating Client Authentication in DTLS for CAPWAP channel. This certificate needs to be installed before the agent installation as mentioned in the Requirements section. If you have more than one certificate, you may make a selection for the correct one here.

This tab can be used to later replace the interface or certificate used by the FortiTelemetry Windows agent.

About

The About tab displays information about the FortiTelemetry Windows agent and connected FortiTelemetry Controller, including:

• FortiTelemetry agent version and serial number.

• FortiTelemetry Controller (FortiGate) information, including the name, version, serial number and connected status.
  

  

Viewing agent logs

By default, the install directory is C:\Program Files\Fortinet\FortiTelemetry.

Logs related to the operation of the FortiTelemetry agent and the monitoring tasks can be located in the output\log directory inside the install directory.