Last updated: 2019-02-27

Installing the Azure Logic Apps Logging and Monitoring agent

In this section you will learn how to install the Azure Logic Apps Logging and Monitoring agent.

You must be a local administrator in order to have the right to install Windows Services.

Before you begin

Make sure you comply with the prerequisites for Azure Logic Apps Logging and Monitoring agent.

Step #1: Start the installer

Double click on the MSI file to start the installation of the agent.
msi

Click the 'Run' button to continue.
warning
Depending on the settings on your Windows server, a security warning may be displayed

Step #2: Welcome screen

On successful execution of the MSI file a Welcome screen will be presented.
Welcome

Click the 'Next' button to continue with the installation process or click on the 'Cancel' button to quit the installer.

Step #3: Custom setup

Select components to install and file folder locations for installation.

Note: Default settings are recommended and each feature maps to one folder

CustomSetup

Click the 'Next' button to continue with the installation process or click on the 'Cancel' button to quit the installer.

Step #4: Service Account Information

This is the account running the Windows Service.

Enter credentials:

Domain: The name of the Domain the Server belongs to. If a local account is being used, use the name of the server or . (dot) as Domain
User: The name of the account
Password: The password for the account.

Note: The account must have Log on as Service Right and Ports must be open. Should not pose a problem at this stage since you dealt with this already when ensuring compliance with the prerequisites.

DomainUser

Click on the 'Next' button to continue with the installation process or click on the 'Cancel' button to quit the installer.

Insufficient privileges Error message when provided account information does not meet the Prerequisites.
InsufficientPrivileges

If you get this message, the most common reason is that the account is not allowed to run as a service or is not local Administrator on the server. Follow the guide How to set Logon as a Service right and click retry. If the problem remains, click cancel and restart. Make sure that the credentials are typed correctly!

Tip: Check the local event log if there are errors (both System and Application)

Step #5 Completed setup

The last step of the installation gives either a success or a premature exit.

Successful installation example:
Completed

Failed installation example:
PrematureExit
A failed installation will render a premature exit

Click the 'Finish' button to Exit and quit the installer.

Step 6: Add Agent as a new Monitoring Agent Configuration

When the setup has successfully completed, your default text editor will open a text file named 'README.txt'. The README.txt file holds additional information that you need in order to add the agent as a Monitoring Agent Configuration. This file is [re]generated on each successful start.
README.txt
Instructions on how to add the Azure Logic Apps Logging and Monitoring agent as a Monitoring Agent Configuration is detailed in a shared article, click on the link below to learn more:


Support

Contact our Support for additional guidance if you fail to resolve the installation problem.

Note: There may be additional information written to the Windows Event logs

Frequently asked questions

Common problems and FAQ for the Logic Apps Logging and Monitoring agent can be found in the troubleshooting page.


Next step

Configuration
Update
Uninstall

Add or manage a Monitoring Agent Configuration
Monitoring Agents
Prerequisites