Foglight for Container Management 2.0

Creating and Activating a Kubernetes Agent

To create a Kubernetes agent on a monitored host:

On the navigation panel, from Standard View click Container Environment or from Expert View click Dashboards > Container. Then the Container dashboard will display as below.

In the Container dashboard, click Administration tab, and then click Create Docker Agent. The Create Docker Agent wizard opens.

Agent Manager: specify the following values, and then click Next.

•

Cluster Name: unique name for the monitored cluster.

•

Agent Manager: select an Agent Manager which manages the agent.

Agent Properties

•

Kubernetes API Service End Point: Get this information from the KubeConfig file. For more information, see Enabling Heapster service in monitored environment .

•

Kubernetes Version: 1.7 by default.


	NOTE: Only need to change for OpenShift clusters.

•

Heapster Service Namespace/Heapster Service Name: Get both values from the Heapster service configuration. For more information, see Enabling Heapster service in monitored environment .


	NOTE: If you monitor OpenShift Origin and enable the Hawkular metrics, then the Heapster Service Namespace should be openshift-infra, and the Heapster Service Name should be https:heapster:.

•

Collected Event Level: Set the collected event level, including ABNORMAL and ALL. ALL will collect both abnormal and normal events while Abnormal only collects abnormal events.

•

Enable Proxy: To enable the proxy, select the checkbox. Enter the Proxy Server Address and Proxy Server Port information.

Credential Verification

•

Do not configure a credential: click Next.


	NOTE: If an existing credential is detected, the screen will prompt, “An existing credential has been detected for this resource and the lockbox won’t be released to the selected Agent manager. To continue the Agent creation steps, manually release the lockbox. Ignore this message if the lockbox has been released and click 'Next' to continue.”.

•

Add cluster to a new credential.

•

Credential Type: Select the credential type from the list and click Next.

•

Credential Properties: Click Load from file to upload the credential and click Next.

•

Credential Name and Lockbox: give a name for the credential, choose a lockbox, then click Next.

•

Resource Mapping: click Next.

•

Policies: Add policies for this credential. This is an optional step. Click Next if you do not wish to add more policies at this time.

Summary: click Finish.

Then, the agent will be created and activated automatically.

Creating and Activating a Docker Swarm Agent

Each Docker Swarm Agent monitored one docker host. If the docker host belongs to a Docker Swarm cluster, it will be considered as a manager/worker node. Otherwise, it will be considered to be a standalone docker host.


	NOTE: For a Docker Swarm cluster, you should create one Docker Swarm Agent for one host in the cluster, and if you want to monitor the whole cluster environment, you need to create all the Docker Swarm Agents for all the hosts in the cluster.

To create a Docker Swarm agent on a monitored host:

On the navigation panel, under Dashboards, click Administration > Agents > Agent Status.

The Agent Status dashboard opens.

In the Agent Status dashboard, click Create Agent.

The Create Agent wizard opens.

Host Selector: Select the monitored host that you want to monitor with the Docker Swarm agent instance that you are about to create, and then click Next.


	NOTE: In order to select the host, the Foglight Agent Manager must be installed and running on the monitored host.

Agent Type and Instance Name: Specify the following values, and then click Next.

•

Agent Type: Select DockerSwarmAgent from the agent type list.

•

Agent Name: Specify the name of the agent instance that you are about to create using either of the following approaches:

•

Generic Name: This option is selected by default. A generic name is a combination of the host name and the agent type and uses the following syntax: agent_type@host_name.

•

Specify Name: Type that name in the Name field. For example, MyAgent.

On the Summary page, review the choices you have made, and then click Finish.

The Agents table refreshes automatically, showing the new Docker Swarm Agent.

On the Agents table, select the Docker Swarm Agent that you create, click Edit Properties, and then click Modify the private properties for this agent.

In the Agents properties view, check if the following values have been configured based upon your environment:

•

Name: give a name to the monitored docker host, it should be unique.

•

Host Name: IP address or host name of the monitored docker host.

•

Docker Remote API End Point: Docker Remote API endpoint of the monitored docker host. For more information, see Enabling Docker Remote API for monitored docker host .

•

Swarm Name: specify the swarm cluster name for display. If the swarm name is kept as “default”, then the cluster name will be displayed as “default (cluster ID)” on the dashboard. If a customized name is input here, then the customized cluster name will be displayed on the dashboard.