InControl is a cloud based device management, monitoring, and reporting tool designed specifically for Peplink and Pepwave devices. We can give the example of a compliance that works as the controller of portable 3G modems on public buses.
We can integrate InControl to Logsign in 2 different ways.
- By syslog forwarding method
- By API method
With these 2 ways, the integration types and the log datas will be distinct. So if you want to make an InControl integration, you'll need to add the device with both of these types integrations.
In the way of syslog, InControl will send the logs about traffic & data usage, identity, session etc. of all the devices that are connected to it. In the API way, Logsign will send an API request to InControl periodically at the time period that you'll set in integration settings, and then InControl will send the total bandwidth usage which is consumed from each connected devices till the time when you set the request.
Integration by Syslog Method
There is no syslog server configuration in the default settings on InControl web interface. So if you want to send the logs by syslog, you must contact to technical support department of Peplink and deal with the case about it. Also, you can contact to your consultant at Peplink for this configuration.
Once your Logsign is configured as the syslog server on Peplink and the log forwarding is started, you can follow these steps to add the device with syslog as below.
1- In Logsign web interface, go to Settings > Data Input > Device List tab and then click on Add New Source button.
2- As we forwarded the logs by syslog, we'll select the source type as SYSLOG.
3- In the opening window, select the vendor as Peplink.
4- In this last section, you need to type the IP address, the description and tag of your device.
After these process, we have completed to added our Peplink device with syslog. Now, you can click on the Search button which appear when you hover the mouse over Device List tab. And you'll be able to create dashboards or reports with these results.
Integration by API Method
In this case, Logsign will send API requests to InControl with the time period that you assign, as mentioned above. To make this integration, you need to go under Settings > Data Input > Device List tab and then click on Add New Source button again. After that, you need to follow the steps as below.
1- After you clicked on Add New Source button, you need to select the source type as PEPLINK.
2- You need to fill the fields respectively as shown in the example below. After all the fields filled in, you can click on Save button to complete the integration process.
Description: The name that we'll assign to our device.
Tag: Tag field named the device to certain word. If you have more than one Peplink devices, you can tag them all with the same word. Then you can filter the results by using EventSource.Tag column and see the logs belonging to named Peplink devices.
Username: Your InControl username.
Password: The password of the username.
Host: The url info that you're using to connect to InControl (must be http).
Api Base: This must be the https form of the url that you typed in the Host field. Logsign will send the API requests to these urls.
Organization: The organization name info that InControl provide you.
Period: This is the time period that Logsign send the API requests periodically. Period count time to second.
EPS: You can specify the EPS (Event Per Second) info manually.
3- After you finished the integration, you can click on the Search button that appear when you hover the mouse over Device List menu, and then you'll be able to analyze the log results.
4- You can see and analyze the log results in Search menu with the query of the source. Here, you can see the the total bandwidth usage from 00.00 a.m. to the time when you run the query. In the column of Bytes.Total, you can see that value. You can create dashboards and reports according to the related query.