Configuration Guide - VMware Solution Exchange
Transcription
Configuration Guide - VMware Solution Exchange
® VMware vRealize Operations Manager Content Pack for vRealize Log Insight Version 1.0 CONFIGURATION GUIDE Contents Overview .......................................................................................................................................... 3 vRealize Operations Manager Content Pack Features ............................................................... 3 Content Pack Components .......................................................................................................... 3 Compatibility ................................................................................................................................ 4 Integration with vRealize Log Insight ............................................................................................... 4 Installing the vRealize Log Insight Agent ..................................................................................... 4 Configuring the vRealize Log Insight Agent ................................................................................ 4 liagent.ini Configuration Options.............................................................................................. 5 liagent.ini Sample Configuration .............................................................................................. 5 Importing a Content pack into vRealize Log Insight .................................................................. 10 Configuring vRealize Log Insight to Send Notification Events .................................................. 10 VMware, Inc. 3401 Hillview Avenue Palo Alto CA 94304 USA Tel 877-486-9273 Fax 650-427-5001 www.vmware.com Copyright © 2015 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. Overview The vRealize Operations Manager content pack for vRealize Log Insight provides a way to analyze all logs redirected from a vRealize Operations Manager instance. The content pack contains various dashboards, queries and alerts to provide better diagnostics and troubleshooting capabilities to the vRealize Operations Manager administrator. The content pack provides the following capabilities: Proactive monitoring and alert notifications of the vRealize Operations Manager clusters. Specific alerts focused on important events that indicate problems can be enabled to send alerts in vRealize Operations Manager as well as send email messages to administrators. Cluster-role specific breakdown of vRealize Operations Manager events. Dashboards are grouped based on the cluster role of the vRealize Operations Manger nodes/slices, such as Master, Data, Replica, and the Remote Collector to provide better manageability. vRealize Operations Manager Content Pack Features The content pack has the following features: Provides log aggregation in vRealize Log Insight. Log files used by vRealize Operations Manager can be configured to redirect to vRealize Log Insight using the vRealize Log Insight agent configuration file. Enables an administrator to monitor and troubleshoot issues using queries and dashboards. After logs are available in vRealize Log Insight, log data is analyzed and displayed according to the various queries and dashboards. Issues could be related to connectivity, system performance, data-related errors and exceptions, or any other abnormal behavior at the vRealize Operations Manager cluster level or at the node (Master, Data, or Remote Collector) level. Provides configurable alert notifications. Configure alerts to send notifications for operations such as multiple unauthenticated access attempts on vRealize Operations Manager. In this example, you could determine if either the credentials of the user have been updated or expired, or someone attempted to compromise the vRealize Operations Manager system. Effective monitoring of health and issues. The content pack presents the logs in a more meaningful way, allowing for focus on the probable causes of failures in vRealize Operations Manager. This can help to improve the reaction time if events are related to known problems. Content Pack Components The vRealize Operation Manager content pack comprises of the following components: 12 Dashboard Groups 81 Dashboard Widgets 18 Queries 8 Alerts 31 Extracted Fields VMware, Inc. 3401 Hillview Avenue Palo Alto CA 94304 USA Tel 877-486-9273 Fax 650-427-5001 www.vmware.com Copyright © 2015 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. Compatibility The vRealize Operations Manager content pack requires vRealize Log Insight version 2.5 and vRealize Operations Manager version 6.0 and 6.0.1. You can download the vRealize Operations Manager content pack from the VMware Solution Exchange: https://solutionexchange.vmware.com/store/loginsight?src=Product_Product_LogInsight_YES_U S. Integration with vRealize Log Insight The vRealize Log Insight agent must be installed and configured to integrate with vRealize Operations Manager. To configure Log Insight agents, complete the following tasks. Installing the vRealize Log Insight Agent Configuring the vRealize Log Insight Agent Importing a Content pack into vRealize Log Insight Configuring vRealize Log Insight to Send Notification Events to vRealize Operations Manager Installing the vRealize Log Insight Agent The vRealize Log Insight agent is included with the vRealize Operations Manager 6.0.1 installation. If using this version of vRealize Operations Manager, you do not have to install the agent separately. If you are using vRealize Operations Manager 6.0, download and install the vRealize Log Insight agent from the following location: https://<Log Insight Instance>/admin/agents# To install or update the vRealize Log Insight Linux agent, see http://pubs.vmware.com/log-insight25/topic/com.vmware.log-insight.administration.doc/GUID-0F1114AB-0315-478C-B84B863ABA393809.html. Configuring the vRealize Log Insight Agent The vRealize Log Insight agent enables the integration and manages communication between vRealize Operations Manager and vRealize Log Insight. The liagent.ini file contains configuration properties that control how the vRealize Log Insight agent sends events to vRealize Log Insight servers, sets the communication protocol and port, and configures flat file log collection. To identify the source and cluster role, tags need to be updated in the liagent.ini configuration file. As administrator, configure the following tags for each node role and on each node in the cluster. The applicable values for Cluster roles are the following. Master Replica Data Remote Collector VMware, Inc. 3401 Hillview Avenue Palo Alto CA 94304 USA Tel 877-486-9273 Fax 650-427-5001 www.vmware.com Copyright © 2015 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. liagent.ini Configuration Options The following is a sample .ini file for the vRealize Log Insight Linux agent. Modify the configuration file according to your environment. The liagent.ini file is available in the following location. /VAR/LIB/LOGINSIGHT-AGENT/ Note: For vRealize Log Insight Windows agents, update the directory of the logs in the liagent.ini file. By default, the logs are available in the following location. C:\data\vcops\log liagent.ini Sample Configuration The following sample is a configuration file for a vRealize Log Insight agent that is configured for vRealize Operations Manger 6.0 and higher. The vRealize Operations Manger content pack for vRealize Log Insight requires that all tags listed below are in the following order to function properly. Please note the following configuration considerations. vmw_vr_ops_appname: do not update this tag vmw_vr_ops_logtype: do not update this tag vmw_vr_ops_clustername: this tag can be updated vmw_vr_ops_clusterrole: change the tag to either the Master, Replica, Data, or Remote Collector vmw_vr_ops_nodename: this tag can be updated vmw_vr_ops_hostname: The IP or FQDN of the vRealize Operations Manager node vmw_vr_ops_hostname: this tag must be updated vmw_vr_ops_clustername: this tag must be updated vmw_vr_ops_clusterrole: this tag can be updated vmw_vr_ops_nodename: this tag can be updated The following configuration applies to a single vRealize Operations Manager node. For every vRealize Operations Manager node, copy the configuration and update the tags accordingly. [filelog|ANALYTICS-analytics] tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"ANALYTICS", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log include = analytics*.log* exclude_fields=hostname [filelog|COLLECTOR-collector] VMware, Inc. 3401 Hillview Avenue Palo Alto CA 94304 USA Tel 877-486-9273 Fax 650-427-5001 www.vmware.com Copyright © 2015 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"COLLECTOR", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log include = collector.log* exclude_fields=hostname event_marker=^\d{4}-\d{2}-\d{2}[\s]\d{2}:\d{2}:\d{2}\,\d{3} [filelog|COLLECTOR-collector_wrapper] tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"COLLECTOR", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log include = collector-wrapper.log* exclude_fields=hostname event_marker=^\d{4}-\d{2}-\d{2}[\s]\d{2}:\d{2}:\d{2}\.\d{3} [filelog|COLLECTOR-collector_gc] directory = /data/vcops/log tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"COLLECTOR", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} include = collector-gc*.log* exclude_fields=hostname event_marker=^\d{4}-\d{2}-\d{2}[\w]\d{2}:\d{2}:\d{2}\.\d{3} [filelog|WEB-web] directory = /data/vcops/log tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"WEB", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} include = web*.log* exclude_fields=hostname event_marker=^\d{4}-\d{2}-\d{2}[\s]\d{2}:\d{2}:\d{2}\,\d{3} [filelog|GEMFIRE-gemfire] tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"GEMFIRE", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} VMware, Inc. 3401 Hillview Avenue Palo Alto CA 94304 USA Tel 877-486-9273 Fax 650-427-5001 www.vmware.com Copyright © 2015 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. directory = /data/vcops/log include = gemfire*.log* exclude_fields=hostname [filelog|VIEW_BRIDGE-view_bridge] tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"VIEW_BRIDGE", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log include = view-bridge*.log* exclude_fields=hostname event_marker=^\d{4}-\d{2}-\d{2}[\s]\d{2}:\d{2}:\d{2}\,\d{3} [filelog|VCOPS_BRIDGE-vcops_bridge] tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"VCOPS_BRIDGE", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log include = vcops-bridge*.log* exclude_fields=hostname event_marker=^\d{4}-\d{2}-\d{2}[\s]\d{2}:\d{2}:\d{2}\,\d{3} [filelog|SUITEAPI-api] directory = /data/vcops/log tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"SUITEAPI", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} include = api.log*;http_api.log*;profiling_api.log* exclude_fields=hostname event_marker=^\d{4}-\d{2}-\d{2}[\s]\d{2}:\d{2}:\d{2}\,\d{3} [filelog|SUITEAPI-suite_api] directory = /data/vcops/log/suite-api tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"SUITEAPI", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} include = *.log* VMware, Inc. 3401 Hillview Avenue Palo Alto CA 94304 USA Tel 877-486-9273 Fax 650-427-5001 www.vmware.com Copyright © 2015 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. exclude_fields=hostname event_marker=^\d{2}-\w{3}-\d{4}[\s]\d{2}:\d{2}:\d{2}\.\d{3} [filelog|ADMIN_UI-admin_ui] tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"ADMIN_UI", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log/casa include = *.log*;*_log* exclude_fields=hostname [filelog|CALL_STACK-call_stack] tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"CALL_STACK", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log/callstack include = analytics*.txt;collector*.txt exclude_fields=hostname [filelog|TOMCAT_WEBAPP-tomcat_webapp] tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"TOMCAT_WEBAPP", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log/product-ui include = *.log*;*_log* exclude_fields=hostname [filelog|OTHER-other1] tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"OTHER", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log include = aim*.log*;calltracer*.log*;casa.audit*.log*;distributed*.log*;hafailove r*.log;his*.log*;installer*.log*;locktrace*.log*;opsapi*.log*;queryservice-timer*.log*;queryprofile*.log*;vcopsConfigureRoles*.log* exclude_fields=hostname event_marker=^\d{4}-\d{2}-\d{2}[\s]\d{2}:\d{2}:\d{2}\,\d{3} VMware, Inc. 3401 Hillview Avenue Palo Alto CA 94304 USA Tel 877-486-9273 Fax 650-427-5001 www.vmware.com Copyright © 2015 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. [filelog|OTHER-other2] tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"OTHER", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log include = env-checker.log* exclude_fields=hostname event_marker=^\d{2}\D{1}\d{2}\D{1}\d{4}\s\d{2}:\d{2}:\d{2} [filelog|OTHER-other3] tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"OTHER", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log include = gfsh*.log*;HTTPPostAdapter*.log*;metagemfire*.log*;migration*.log* exclude_fields=hostname [filelog|OTHER-watchdog] tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"OTHER", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log/vcops-watchdog include = vcops-watchdog.log* exclude_fields=hostname event_marker=^\d{4}-\d{2}-\d{2}[\s]\d{2}:\d{2}:\d{2}\,\d{3} [filelog|ADAPTER-vmwareadapter] tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"ADAPTER", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log/adapters/VMwareAdapter include = *.log* exclude_fields=hostname event_marker=^\d{4}-\d{2}-\d{2}[\s]\d{2}:\d{2}:\d{2}\,\d{3} [filelog|ADAPTER-vcopsadapter] VMware, Inc. 3401 Hillview Avenue Palo Alto CA 94304 USA Tel 877-486-9273 Fax 650-427-5001 www.vmware.com Copyright © 2015 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"ADAPTER", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log/adapters/VCOpsAdapter include = *.log* exclude_fields=hostname event_marker=^\d{4}-\d{2}-\d{2}[\s]\d{2}:\d{2}:\d{2}\,\d{3} [filelog|ADAPTER-openapiadapter] tags = {"vmw_vr_ops_appname":"vROps", "vmw_vr_ops_logtype":"ADAPTER", "vmw_vr_ops_clustername":"Cluster1", "vmw_vr_ops_clusterrole":"Master", "vmw_vr_ops_nodename":"Node1", "vmw_vr_ops_hostname":"1.2.3.4"} directory = /data/vcops/log/adapters/OpenAPIAdapter include = *.log* exclude_fields=hostname event_marker=^\d{4}-\d{2}-\d{2}[\s]\d{2}:\d{2}:\d{2}\,\d{3} Importing a Content pack into vRealize Log Insight You must import the content pack into a vRealize Log Insight instance to view vRealize Operations Manager dashboards, queries, and alerts. Prerequisites Verify that the vRealize Log Insight agent file is configured. Verify that you are logged in to the vRealize Log Insight Web user interface as a user with the Edit Admin permission. The URL format is https://log-insight-host, where loginsight-host is the IP address or host name of the vRealize Log Insight virtual appliance. Procedure To import a content pack, perform the following steps. 1. Log into vRealize Log insight as Admin. 2. Click the configuration drop-down menu and select Content Packs. 3. Click the Import Content Pack button. 4. Browse to the vlcp file for the content pack and click Open. 5. Select Install as Content Pack and click Import. Configuring vRealize Log Insight to Send Notification Events vRealize Operations Manager content pack alerts can be sent as notification events to vRealize Operations Manager. Prerequisites VMware, Inc. 3401 Hillview Avenue Palo Alto CA 94304 USA Tel 877-486-9273 Fax 650-427-5001 www.vmware.com Copyright © 2015 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies. Verify that you know the IP address or host name of the target vRealize Operations Manager instance. Verify that you are logged in to the vRealize Log Insight Web user interface as a user with the Edit Admin permission. The URL format is https://log-insight-host, where loginsight-host is the IP address or host name of the vRealize Log Insight virtual appliance. Procedure To integrate vRealize Log Insight to send alert notifications to vRealize Operations Manager, perform the following steps. 1. Log into vRealize Log Insight as Admin. 2. Click the configuration drop-down menu icon and select Administration. 3. Under Integration, select vRealize Operations Manager. 4. Type the IP address or host name, and user credentials for the vRealize Operations Manager Master Node of the vRealize Operations Manager instance. 5. Select Enable alerts integration. 6. Click Test Connection. 7. Click Save. VMware, Inc. 3401 Hillview Avenue Palo Alto CA 94304 USA Tel 877-486-9273 Fax 650-427-5001 www.vmware.com Copyright © 2015 VMware, Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. VMware products are covered by one or more patents listed at http://www.vmware.com/go/patents. VMware is a registered trademark or trademark of VMware, Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies.