Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added how to import dashboards examples to kibana #1559

Merged
merged 2 commits into from Mar 26, 2018
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
Expand Up @@ -8,6 +8,8 @@ feature_status: In Development
---
# oVirt Metrics - Installation Guide

[![oVirt Metrics data flow](/images/wiki/oVirtMetricsDataFlow.jpg)](/images/wiki/oVirtMetricsDataFlow.jpg)

## oVirt Metrics Store Setup

**Note:** Currently, the oVirt Metrics Store should be installed on a new machine, separate from the engine.
Expand Down Expand Up @@ -69,7 +71,7 @@ To copy the engine public key to your metrics store machine, run:

# ssh-keygen -y -f $mytemp/engine_id_rsa > $mytemp/engine_id_rsa.pub

# ssh-copy-id -i $mytemp/engine_id_rsa.pub root@fluentd_elasticsearch_host
# ssh-copy-id -i $mytemp/engine_id_rsa.pub root@{fluentd_elasticsearch_host}

It should ask for root password (on first attempt), supply it.
After that, run:
Expand All @@ -78,7 +80,7 @@ After that, run:

To test that you are able to log into the metrics store machine from the engine, run:

# ssh -i /etc/pki/ovirt-engine/keys/engine_id_rsa root@fluentd_elasticsearch_host
# ssh -i /etc/pki/ovirt-engine/keys/engine_id_rsa root@{fluentd_elasticsearch_host}

### Run ovirt-metrics-store-installation playbook

Expand All @@ -88,34 +90,25 @@ to the metrics store machine.
# /usr/share/ovirt-engine-metrics/setup/ansible/configure_ovirt_hosts_for_metrics.sh \
--playbook=ovirt-metrics-store-installation.yml

### Metrics Store Installation

Please follow the installation instructions: [Metrics Store setup on top of OpenShift](https://github.com/ViaQ/Main/blob/master/README-install.md)

**Note:** When running ansible to configure OpenShift, use the ansible-inventy file based on your OpenShift version and flavor.
### Metrics Store Installation

In oVirt 4.2 there will be an option to add SSO: [Metrics Store setup on top of OpenShift with oVirt Engine SSO](https://www.ovirt.org/blog/2017/05/openshift-openId-integration-with-engine-sso/)
To install OpenShift Logging on your machine (Elasticsearch, Kibana, Fluentd, Curator), Please follow the installation instructions: [Metrics Store setup on top of OpenShift](https://www.ovirt.org/develop/release-management/features/metrics/setting-up-viaq-logging.md)


[![oVirt Metrics data flow](/images/wiki/oVirtMetricsDataFlow.jpg)](/images/wiki/oVirtMetricsDataFlow.jpg)
Optional in oVirt 4.2, add SSO: [Metrics Store setup on top of OpenShift with oVirt Engine SSO](https://www.ovirt.org/blog/2017/05/openshift-openId-integration-with-engine-sso/)

Once you have finished this step, you should have:

* Kibana - <https://kibana.{hostname}>
* OpenShift portal - <https://openshift.{hostname}>
* Kibana - <https://kibana.{fluentd_elasticsearch_host}>
* OpenShift portal - <https://{fluentd_elasticsearch_host}:8443>


## oVirt Hypervisors and Engine Setup ##

Now we need to deploy and configure collectd and fluentd to send the data to the central metrics store::
Deploy and configure collectd and fluentd to send the data to the central metrics store::

1. This requires installing / upgrading and setting up oVirt Engine 4.1.8 and above.
Until version 4.1.8 is available, you can use the snapshots repository to get the latest ovirt-engine-metrics package.
http://resources.ovirt.org/pub/ovirt-4.1-snapshot/rpm/
1. This requires installing / upgrading and setting up oVirt Engine latest 4.2.z.

2. This requires installing / upgrading and activating one or more hosts from version 4.1.8 or above.
Until version 4.1.8 is available, You can use the snapshots repository to get the latest ovirt-engine-metrics package.
http://resources.ovirt.org/pub/ovirt-4.1-snapshot/rpm/
2. This requires installing / upgrading and activating one or more hosts from version 4.2.z.

3. On the engine machine, run as root:

Expand All @@ -128,4 +121,23 @@ It should finish without errors, collectd and fluentd services should be running
Once finished, you can view host, VM and other statistics, in the Kibana console,
at the address configured earlier on in this procedure [(see oVirt Metrics Store Setup)](https://github.com/ViaQ/Main/blob/master/README-install.md#running-kibana).

Kibana should be available at <https://kibana.{hostname}>

## Example Dashboards

Kibana should be available at <https://kibana.{fluentd_elasticsearch_host}>

Dashboard examples include `System Dashboard`, `Hosts Dashboard`, `VMs Dashboard`, `Processes Dashboard`.

If you wish to import dashboards example, you will need to import visualization and dashboards manually from the Kibana UI.

1. Copy the /etc/ovirt-engine-metrics/dashboards-examples directory to your local machine.

2. Go to the Kibana UI, to the `setting` -> `objects`.

3. Import the `Searches`.

4. Import the `Visualizations`.

5. Import the `Dashboards`.

You are done! Go to the `Dashboard` tab in the Kibana UI and choose a dashboard.