VMware Log Insight provides an easy, at a glance, view of an entire VMware environment including NSX and other components. Additionally available content packs provide predefined knowledge about events. Problems with a vSphere environment can be identified by simply looking at the Overview dashboard.
This post describes how to integrate all NSX Components into VMware Log Insight.
NSX Content Pack Installation
VMware Log Insight basically works without Content Packs, but it is highly recommended to install the Content Pack if you want to integrate NSX. Content packs are plugins that provide predefined knowledge about events.
- Login to VMware Log Insight web interface
- Open the menu in the right upper corner and select Content Packs
- Locate the VMware - NSX-vSphere Content Pack
- Accept the License Agreement and click Install
VMware Log Insight acts as Syslog server. To fully integrate your NSX platform into Log Insight, logs from the following sources needs to be forwarded:
- ESXi Hosts
- NSX Manager
- NSX Controllers
- NSX Edges
Forward ESXi Hosts Logs to Log Insight
Syslog config on ESXi Hosts are configured during the initial Log Insight installation, so they should be already configured. You can verify syslog configuration on an ESXi Host with
esxcli system syslog config get
Log Insight can automatically add all ESXi Hosts that are in the vCenter Server Inventory. Open the Log Insight web interface and navigate to Administration > Integration > vSphere and enter vCenter Server connection details.
Forward NSX Manager Logs to Log Insight
NSX Manger Syslog settings are configured in the appliance configuration, not in the vSphere Web Client.
- Log in to the NSX Manager virtual appliance (https://[NSX-Manager]/)
- Open Manage Appliance Settings
- Within Settings > General panel click Edit next to Syslog Server
- Enter IP address, Port and Protocol of the Log Insight server. The default syslog port is 514/UDP. You can also use the DNS name here, but I prefer to use IP addresses as syslog destinations. This allows syslog to function even when the DNS is down.
- Click OK
NSX Manager Logs are now forwarded to Log Insight.
Forward NSX Controller Logs to Log Insight
The only supported method on configuring the syslog server on NSX controllers is through the NSX API. To use the API, you need a REST Client. Syslog settings have to be configured on each controller.
- Identify NSX Controller IDs. Open the vSphere Web Client and navigate to Network and Security > Installation > NSX Controller nodes. Controller IDs in this example are:- controller-1
- If you don't already have a REST Client, you can install Advanced REST client from the chrome web store.
- Prepare the REST Request:Method: POST
Authorization: NSX Manager Login
<controllerSyslogServer> <syslogServer>[Log-Insight]</syslogServer> <port>514</port> <protocol>UDP</protocol> <level>INFO</level> </controllerSyslogServer>
- When using the Advanced REST client, the call should look like this:
- Repeat Step 3+4 for all NSX Controllers
NSX Controller Logs are now forwarded to Log Insight.
Forward NSX Edge Logs to Log Insight
NSX Edge Syslog settings are configured in the vSphere Web Client. Syslog settings have to be configured on each Edge.
- Open the vSphere Web Client, navigate to Network and Security > NSX Edges and double-click the Edge Gateway
- Navigate to Manage > Settings > Configuration and click Change next to Syslog servers
- Enter IP address of the Log Insight server and set the protocol to udp
- Repeat Step 1+3 for all NSX Edges
NSX Edge Gateway Logs are now forwarded to Log Insight.