To set up Magic Suite apps to connect to your LogicMonitor system:

1. From the Admin menu, click Connections
2. Click the Create button and choose the connection type of LogicMonitor
3. Enter a name - we recommend that you use "Default" for the name of the first connection of each type, and optionally, a description.
4. In the URL field, enter the system URL e.g. https://mycompany.logicmonitor.com
5. in the Username field, enter the Access ID (OR leave blank if you are using Bearer Token authentication)
6. In the Password field, enter the Access Key (OR the Bearer Token)
7. Established customers with larger reports may wish to set up caching (see below)
8. Click Save

Note: passwords are stored encrypted in our database, and cannot be accessed by any other users of the system.

You can set an optional 'max back-off' time in the Configuration section as a JSON key-value pair (example below), which is the maximum amount of time we will wait after receiving 'too many requests' from LogicMonitor. The default value is 300 seconds, unless overridden in the Configuration.

To override it, enter something like the following:

{
   "MaximumBackOffSeconds" : 123456789
}

Roles and Users When Connecting to LogicMonitor

If you have the relevant permissions, when connecting to LogicMonitor, you will want to set up a role and user whose minimal requirements are to be able to view Devices - whether all Devices or Devices in a particular Device Group(s).

Role

• General
• Use a meaningful name, for example, "ReportMagic Role".
• Disable the Chat with Engineer button
• Dashboards:
• Not allowed to create private dashboards
• No rights to any shared dashboards
• Devices:
• View permissions *only* for all Device Groups *or* specific Device Groups (as appropriate dependent on reporting requirements).
• There is no requirement to grant Acknowledge or Manage rights for any Devices.
• Services:
• View rights to services
• Reports:
• No rights to any Reports
• Settings:
• View settings *only*. Role does not require Manage Settings rights.

User

• Use a meaningful username, for example, reportmagic. As this will be passed in HTTP calls to the API, best practice suggests avoiding spaces.
• Use a password in keeping with you and/or your customer's security policies
• View Permission for the Hosts (Devices) tab only. The per-user View permissions relate only to visibility within the UI and do not affect the API's abilities. The User wizard does not permit the selection of no options here, otherwise this would be the recommendation.
• Assign the user to the ReportMagic Role.

Note: at your discretion, you may grant additional rights or re-use an existing, less restrictive Role, or even use an existing User with additional rights up to full Administrator access, however this would not be best practice.

LogicMonitor DataMagic

For information on setting up your connection suitable for LogicMonitor DataMagic, see this help article.