OpenStack運用者ガイド - software.fujitsu.comsoftware.fujitsu.com/jp/manual/manualfiles/m160010/j2ul2187/01z000/j2... · 本書について本書では、OpenStack運用者がどのようにFUJITSU

FUJITSU SoftwareServerViewCloud Monitoring Manager V1.1

OpenStack運用者ガイド

J2UL-2187-01Z0(00)2016年10月

本書について

本書では、OpenStack運用者がどのようにFUJITSU ServerView Cloud Monitoring Manager(以下Cloud Monitoring Manager［CMM］)のOpenStackプラットフォームをモニタリングできるかを説明します。

本書の構成は以下のとおりです。

章説明

第1章導入 CMMおよびOpenStackプラットフォームのモニタリングの基本的な使用シ

ナリオを紹介します。

第2章インストール OpenStackプラットフォームのモニタリングに必要なCMMコンポーネントの

インストール方法を説明します。

第3章テナントユーザーのための準備テナントユーザー向けのモニタリング環境を準備する方法を説明します。

第4章サービスおよびサーバのモニタリング OpenStackサービスおよびサーバのモニタリングに含まれる基本的なタス

クを説明します。

第5章ログデータの管理 OpenStackサービスおよびサーバのログデータの管理に含まれる基本的な

タスクを説明します。

付録A 構成設定 CMMメトリックエージェントおよびCMMログエージェントの構成設定につ

いて説明します。

付録B 対応メトリック CMMがサポートするメトリックについて説明します。

付録C 用語集 CMMに関連する重要な用語を定義します。

本書の読者

本書は、OpenStackプラットフォーム上のクラウドリソースをモニタリングするためにCMMを利用するOpenStack運用者に向けて書かれた

ものです。

本書は、OpenStackの深い知識を持つことを前提とします。必要なCMMコンポーネントをインストールするためには、LINUXシステムの管理

および運用の知識を持つことを前提とします。

本書の表記本書中の表記方法は以下のとおりです。

[Add] フィールドなどのGUI要素の名前は角括弧で括ります。

init コマンド名やキーボード入力する文字列などのシステム名は、フォントをCourierとします。

<variable> 値の入力が必要な変数は山括弧で括ります。

[option] 任意のコマンドパラメーターなどのオプション項目は、角括弧で括ります。

one | two 選択性の入力項目は縦線で区切ります。

{one | two} 選択性の必須入力項目は中括弧で括ります。

略称本書では、以下のような略称を使用します。

CMM Cloud Monitoring Manager

IaaS Infrastructure as a Service

ICMP インターネット制御メッセージプロトコル　(Internet Control Message Protocol)

OS オペレーティングシステム (Operating System)

- i -

OSS オープンソースソフトウェア (Open Source Software)

PaaS Platform as a Service

SaaS Software as a Service

参照可能なドキュメント

CMMに関する以下の情報が参照可能です。

・解説書：　CMMを紹介するマニュアル。CMMを利用するすべての人に向けて書かれています。

・テナントユーザーガイド：　テナントユーザー向けのマニュアルで、CMMを利用して、OpenStackのサービスと仮想マシンをモニタリ

ングする方法を説明しています。

・ OpenStack運用者ガイド：　OpenStack運用者向けのマニュアルで、CMMを利用して、OpenStackサービスをモニタリングする方法、お

よびOpenStackサービスから入手可能なログデータを管理する方法を説明しています。

・管理者ガイド:　CMM管理者向けのマニュアルで、CMMをインストール、管理、保守する方法を説明しています。

関連するWeb参照先

下記のWeb上の参照先により、CMMと統合するオープンリソースの情報を提供します。

・ OpenStack：基盤となるプラットフォーム技術であるOpenStackに関する情報。

・ OpenStack Horizon：OpenStack Horizonダッシュボードに関する情報。

・ Monasca Wiki：CMMのコアであるMonascaに関する情報。

本書で提供しているより詳細なWeb上の参照先は予告なく変更される場合があります。

商標

LINUXは、Linus Torvaldsの登録商標です。

OpenStack(R)のワードマークと OpenStack のロゴは、米国とその他の国における OpenStack Foundation の登録商標/サービスマークまたは

商標/サービスマークのどちらかであり、OpenStack Foundation の許諾の下に使用されています。富士通株式会社は、OpenStackFoundation とOpenStack コミュニティの公認や出資を受けていません。

Red Hatは、Red Hat, Inc.の米国およびその他の国における登録商標または商標です。

Java® は、Oracleおよびその関連企業の登録商標です。

PythonおよびPyConは、Pythonソフトウェア財団の商標です。

ServerViewとSystemwalkerは、富士通株式会社の登録商標です。

その他の会社名および製品名は、それぞれの会社の商標または登録商標です。

著作権

Copyright FUJITSU LIMITED 2015 - 2016

本書を無断でほかに転載しないようお願いします。富士通は、OpenStack FoundationやOpenStackコミュニティーの関連企業ではなく、また

支援や出資も受けていません。

輸出規制

- ii -

http://docs.openstack.org/

http://docs.openstack.org/developer/horizon/

https://wiki.openstack.org/wiki/Monasca

本ドキュメントを輸出または第三者へ提供する場合は、お客さまが居住する国および米国輸出管理関連法規等の規制をご確認のうえ、必要

な手続きをおとりください。

- iii -

目次

第1章導入................................................................................................................................................................................ 11.1 基本的な使用シナリオ........................................................................................................................................................................ 11.2 OpenStack運用者のタスク...................................................................................................................................................................21.3 コンポーネント......................................................................................................................................................................................21.4 ユーザー管理......................................................................................................................................................................................3

第2章インストール.....................................................................................................................................................................52.1 前提条件と準備...................................................................................................................................................................................6

2.1.1 前提条件...................................................................................................................................................................................... 62.1.2 コントロールマシン........................................................................................................................................................................62.1.3 CMMソフトウェアとセットアップユーティリティ............................................................................................................................. 72.1.4 セキュリティ................................................................................................................................................................................... 82.1.5 HTTPSサポート............................................................................................................................................................................ 92.1.6 Pythonパッケージ......................................................................................................................................................................... 92.1.7 Bashの設定...................................................................................................................................................................................9

2.2 コントロールマシンの設定.................................................................................................................................................................102.3 OpenStackエクステンションのインストール....................................................................................................................................... 112.4 CMMメトリックエージェントのインストール........................................................................................................................................13

2.4.1 インストール................................................................................................................................................................................ 142.4.2 設定............................................................................................................................................................................................ 16

2.5 CMMログエージェントのインストール...............................................................................................................................................172.5.1 インストール................................................................................................................................................................................ 172.5.2 設定............................................................................................................................................................................................ 19

2.6 運用と保守.........................................................................................................................................................................................212.6.1 エージェントの起動と停止......................................................................................................................................................... 212.6.2 CMMメトリックエージェントのメトリックの無効化........................................................................................................................222.6.3 CMMログエージェントのログデータの無効化.......................................................................................................................... 222.6.4 エージェントログファイルの収集................................................................................................................................................ 232.6.5 バックアップとリカバリ................................................................................................................................................................. 23

2.7 アンインストール................................................................................................................................................................................ 23

第3章テナントユーザーのための準備...................................................................................................................................... 253.1 OpenStackにおけるロールとユーザーアカウントの作成..................................................................................................................253.2 CMMメトリックエージェントのインストール........................................................................................................................................253.3 追加のライブラリのインストール........................................................................................................................................................ 253.4 CMMメトリックエージェントの設定.................................................................................................................................................... 26

第4章サービスおよびサーバのモニタリング............................................................................................................................. 274.1 サービスおよびサーバの概要.......................................................................................................................................................... 274.2 モニタリングデータの可視化.............................................................................................................................................................274.3 アラームの定義..................................................................................................................................................................................284.4 通知の定義........................................................................................................................................................................................29

第5章ログデータの管理.......................................................................................................................................................... 305.1 インデックスパターンの設定............................................................................................................................................................. 305.2 ログ管理ダッシュボードの利用......................................................................................................................................................... 31

付録A 構成設定.......................................................................................................................................................................32A.1 CMMメトリックエージェントの構成設定........................................................................................................................................... 32A.2 CMMログエージェントの構成設定..................................................................................................................................................33

付録B 対応メトリック.................................................................................................................................................................35B.1 標準メトリック..................................................................................................................................................................................... 35B.2 追加メトリック..................................................................................................................................................................................... 35

付録C 用語集..........................................................................................................................................................................41

- iv -

第1章導入

クラウドシステムに配備されるアプリケーションはますます増え、クラウドシステムが複雑になってきているため、クラウドインフラを管理す

ることが困難になってきています。Cloud Monitoring Manager(CMM)は、OpenStackベースのクラウドコンピューティングプラットフォーム上

で動作する高性能なMonitoring as a Serviceソリューションを提供することでこの課題を克服するのを支援します。

OpenStackのコンポーネントアーキテクチャーは高い柔軟性を提供しますが、複数のサービスを扱う必要があるため、システム運用の負荷が

高くなリます。CMMは、すべてのサービスの総合的なビューを提供し、１つのアクセスポイントに、メトリックとログデータを集約します。CMMは、OpenStackプラットフォームに対する変更をすぐに反映できるよう柔軟性と拡張性を持ちながら、マルチテナント機能、高可用性、お

よびデータセキュリティの確保に必要な手段を提供します。

CMMは、Monitoring as a Serviceソリューションのあらゆる側面をカバーしています。

・中規模および大規模なOpenStack配備のモニタリングデータの集中管理。

・耐障害性のあるモニタリングデータの保存。

・拡大するクラウドインフラをサポートするための拡張性。物理サーバと仮想サーバがさまざまな負荷に対して拡大縮小する場合に、そ

れに応じてモニタリングおよびログ管理ソリューションを対応させることができます。

1.1 基本的な使用シナリオ

CMMのモニタリングサービスのセットアップと使用に関する基本的な使用シナリオを以下に示します。

テナントユーザーは、OpenStack環境においてサービスプロバイダーとして位置付けられます。テナントユーザーは、エンドユーザーに

サービスを提供したり、自身の開発に必要となるサービスをホストしたりするために、仮想マシンを配備します。CMMにより、テナントユ

ーザーは、それぞれのサービス、およびサービスを提供するサーバが仕様どおりの設定で動作しているかを確認できます。

OpenStack運用者は、OpenStackプラットフォームの管理と保守を行う特別なテナントユーザーです。CMMのモニタリングおよびログ管理

サービスにより、プラットフォームの可用性および品質を確保することができます。以下の場合にCMMを使用します。

・物理および仮想サーバ、ハイパーバイザー、およびOpenStackサービスのモニタリング。

・データベースサービスなどの、ミドルウェアコンポーネントのモニタリング。

・ OpenStackサービスおよびサーバ、ミドルウェアコンポーネントおよび運用システムのログデータの取得および分析。

CMM管理者は、テナントユーザーとOpenStack運用者に、モニタリングサービスとログ管理サービスを提供します。これにより、テナント

ユーザーとOpenStack運用者は操作に集中し、独自のシステムモニタリングソフトウェアのセットアップや管理に伴う大変な作業を実施す

ることなく、サービスやサーバの品質を確保できます。CMM管理者は、CMMの品質を確保するために、モニタリングサービスを自分自身に

使用します。

- 1 -

1.2 OpenStack運用者のタスク

OpenStackサービスとサーバのモニタリングにCMMを利用するためには、以下のエージェントをインストールし、設定する必要があります。

・サービスおよびサーバのモニタリングには、CMMメトリックエージェントが必要です。

・サービスおよびサーバに生成されるログデータの収集には、CMMログエージェントが必要です。

モニタリング

CMMメトリックエージェントは、モニタリング対象のサービスが動作している仮想サーバや物理サーバごとにインストールできます。エー

ジェントはメトリックにクエリを行い、そのデータはCMMサービスに送信されて処理されます。

メトリックは、一つの名前と一連のディメンションによって一意に特定される自己記述型のデータ構造です。各ディメンションは、キーと値の

ペアから構成されます。キーと値には、例えば、リージョン、アベイラビリティーゾーン、サービス層、リソースIDなどを使用して、モニタリ

ングしたいデータを柔軟かつ簡潔に記述できます。

CMMメトリックエージェントは、以下を含むさまざまなタイプのメトリックをサポートします。

・ CPU使用量、使用ディスク領域、ネットワークトラフィックなどのシステムメトリック。

・ホストの死活チェック。ping(ICMP)またはSSHを使用してホストが動作しているかどうかを確認できます。

・プロセスチェック。例えば、プロセス数、メモリサイズ、スレッド数など、プロセスをモニタリングできます。

・ HTTPエンドポイントチェック。HTTPリクエストを送信しCMMサービスに成否を報告することで、HTTPエンドポイントが動作しているか

停止しているかを確認できます。

・サービスのチェック。MySQL、Kafka、RabbitMQなどのミドルウェアサービスをチェックできます。

・ OpenStackサービスのチェック。OpenStackサービスの一部である各プロセスに関するチェックを実行できます。

個別のエージェント設定によって、サービスおよびサーバのモニタリングに利用できるメトリックを定義できます。CMMメトリックエージェ

ントのインストールおよび設定の詳細は、2.4 CMMメトリックエージェントのインストールを参照してください。

エージェントが利用可能になったら、CMMモニタリング機能にアクセスできます。クラウドインフラにシームレスに統合されたGUIを使用し

ます。OpenStack Horizonにより、すべてのモニタリング機能と大規模なモニタリング結果データに、ユーザーインターフェイスからアクセ

スすることができます。快適なダッシュボードで、クラウドリソースの健全性と状態が可視化されます。

CMMは、アラームの通知や管理のための機能を提供します。テンプレートベースのアラーム定義により、動的に変化するリソースを、再設定

することなくモニタリングできます。仮想マシンの数が変化しても、スケーラブルなクラウドサービスを効率的にモニタリングすることが可能

です。アラームの発生をCMM利用者に知らせる通知を設定することができます。

モニタリング機能に関する詳細は、第4章サービスおよびサーバのモニタリングを参照してください。

ログ管理

CMMログエージェントは、ログデータを取得したい物理サーバや仮想サーバごとにインストールおよび設定ができます。エージェントが

サービスやサーバから収集したログファイルは、CMMサービスに送信されて処理されます。CMMログエージェントのインストールおよび

設定の詳細については、2.5 CMMログエージェントのインストールを参照してください。

CMMは、ログデータを中央データベースに保存します。これが、CMM利用者用のログデータを可視化する際の基礎となります。さまざ

まなグラフ、表、およびマップにより、ログデータの高度なデータ分析と可視化をサポートします。可視化されたグラフ等のGUI部品は、ダ

ッシュボード内で簡単に組み合わせることができます。そして、検索クエリにより、ダッシュボードにはリアルタイムに変更された内容が表示

されます。

OpenStack Horizonにより、カスタマイズ可能なダッシュボードがクラウドインフラにシームレスに統合されます。これにより、すべてのログ管

理機能へのアクセスが可能になります。

ログ管理機能に関する詳細は、第5章ログデータの管理を参照してください。

1.3 コンポーネント

以下に、CMMの主なコンポーネントを図示します。

- 2 -

OpenStack

CMMは、パブリックおよびプライベートのクラウドコンピューティングプラットフォームを構築する技術にOpenStackを利用しています。

OpenStackは、クラウドインフラソリューション用の多様なコンポーネントを供給し、IaaS (Infrastructure as a Service)の展開と管理を可能に

する、相互関連プロジェクトで構成されています。

CMMサービス

CMMサービスはCMMの中心となるコンポーネントです。ユーザーへのデータ提供のほか、メトリックデータおよびログデータの受信、保持、

および処理を行います。

CMMサービスは、Monascaに依存しています。Monascaを使用して高速なメトリックの問い合わせを実現し、Monascaのストリーミングア

ラームエンジンおよび通知エンジンを統合しています。詳細は、Monasca Wikiを参照してください。

CMM Horizonプラグイン

CMMには、OpenStack Horizonダッシュボード用のプラグインが同梱されています。そのプラグインは、OpenStackのメインダッシュボー

ドに、モニタリング用のビューを提供します。これにより、CMM利用者は、WebベースのGUIからモニタリング機能にアクセスできるように

なります。詳細については、OpenStack Horizon documentationを参照してください。

OpenStack Horizonにより、モニタリングデータは、下記のアプリケーションと完全に統合する快適で利用しやすいダッシュボード上で可視化

できます。

・ Grafana（メトリックデータ用）。大規模測定データを可視化するオープンソースアプリケーション。

・ Kibana（ログデータ用）。Elasticsearchを運用するために設計されたオープンソースの分析および可視化プラットフォーム。

CMMメトリックエージェント

メトリックを収集してCMMサービスに送信するためには、CMMメトリックエージェントが必要です。本エージェントは、組み込みのシステ

ムチェックとサービスチェックに加えて、さまざまなメトリックをサポートしています。モニタリングしたい仮想サーバや物理サーバごとにCMMメトリックエージェントをインストールすることができます。

本エージェント機能は、Monascaプロジェクトのソースコードベースに完全に統合されています。詳細は、Monasca Wikiを参照してくだ

さい。

CMMログエージェント

CMMログエージェントは、ログデータを収集し、その後の処理のために、CMMサービスに転送するうえで必要です。ログデータを収集し

たい仮想サーバや物理サーバごとにインストールすることができます。

本エージェント機能は、Monascaプロジェクトのソースコードベースに完全に統合されています。詳細は、Monasca Wikiを参照してくだ

さい。

1.4 ユーザー管理

CMMは、OpenStack上で共通の認証認可サービスであるKeystoneと完全に統合されています。

- 3 -


http://docs.openstack.org/developer/horizon/



CMMのKeystoneへの統合により、あらゆるCMM利用者をOpenStackユーザーとして登録することが必要になります。CMMにおける認

証認可はすべてKeystoneを介して実施されます。例えば、モニタリングデータをユーザーが要求する場合、CMMでは、そのユーザーが

OpenStackにおいて有効なユーザーであり、要求されたメトリックにアクセスできることを確認します。

CMM利用者は、OpenStack上で作成され管理されます。

・各利用者は、OpenStackにおいて、特定の操作を実行するための役割(ロール)を持っています。OpenStackのロールは権利と権限を

定義します。

・各利用者には、少なくとも1つのOpenStackプロジェクトが割り当てられます。プロジェクトは、割り当てられたユーザーがアクセスでき

るリソースの集合を定義する組織単位です。

CMMのテナントユーザーは、割り当てられたプロジェクトに定義されるリソースをモニタリングできます。

ユーザー管理に関する詳細は、OpenStack documentationを参照してください。

- 4 -

http://docs.openstack.org/

第2章インストール

CMMのインストールは幾つかのステップで構成されています。これらのステップの一部はCMM管理者が、一部はOpenStack運用者が実行

します。

CMMのインストールは、以下のステップで構成されています。

1. インストール環境の準備（OpenStack運用者とCMM管理者が実施）。

2. コントロールマシンの設定（OpenStack運用者とCMM管理者が実施）。

3. オフラインリソースのインストール（CMM管理者が実施）。

4. CMMサービスに必要なOpenStackエクステンションのインストール（OpenStack運用者が実施）。

5. CMMサービスのインストール（CMM管理者が実施）。

OpenStack運用者は、OpenStackプラットフォームをモニタリングするためのエージェントのインストールおよび設定も行います。

CMMにはAnsibleに基づくインストーラが同梱されています。このインストーラは、OpenStackエクステンションと必要なエージェントをイン

ストールするために使用します。

推奨インストール環境

推奨するインストール環境は以下のとおりです。

- 5 -

・デフォルトでは、CMM管理者はオフラインリソース、CMMコンポーネント、必要なエージェントを１台のホスト（CMMホスト）にインス

トールします。

・ OpenStack運用者として、OpenStackエクステンションと、OpenStack KeystoneサービスおよびOpenStack Horizonサービスに必要な

エージェントをインストールします。OpenStack環境に応じて、KeystoneとHorizonを同じホストに、または、２台のホストに別々にイン

ストールすることもできます。

OpenStackサービスの追加に応じて、モニタリング用のエージェントを追加インストールすることができます。

CMMコンポーネントのインストールは、コントロールマシンから管理します。

2.1 前提条件と準備

後述のセクションでは、OpenStackエクステンションおよび必要なエージェントをインストールするための前提条件と事前準備について説明

します。

2.1.1 前提条件

CMMは、以下のオペレーティングシステムが導入済みのホストマシンにインストール可能です。

・ Red Hat Enterprise Linux 7.2 (for Intel64)

基盤となるプラットフォーム技術として、以下のOpenStackプラットフォームがサポートされています。

・ Red Hat Enterprise Linux OpenStack Platform 8

CMMは、以下のWebブラウザをサポートしています。

・ Google Chrome 52.0

・ Microsoft Internet Explorer 11.0 (互換表示を無効化した状態)

・ Mozilla Firefox ESR 45.0

2.1.2 コントロールマシン

CMMのインストールには、コントロールマシンが使用されます。コントロールマシンは、ソフトウェアコンポーネントのインストール先となる

リモートマシンの管理に利用可能な別のマシンです。

リモートマシンは、SSHプロトコルで管理します。

- 6 -

コントロールマシンは、下記のシステム要件を満たさなければなりません。

・ Ansible 1.9のインストールと準備を後述のとおり行う必要があります。Ansibleはアプリケーションやシステムの配備を容易にするシン

プルなIT自動化プラットフォームです。CMMの自動インストールはAnsibleプレイブックに基づいており、Ansible 1.9.6を使用してテスト

済みです。

・ Python 2.7がインストールされていること

コントロールマシンに必要なオペレーティングシステムの詳細については、Ansible documentationを参照してください。

以下を実施し、コントロールマシンにAnsibleのインストールと準備を行ってください。

1. コントロールマシンにログインします。

2. EPEL (Extra Packages for Enterprise Linux)用の以下のリポジトリを有効にします。

・ optional リポジトリ (rhel-7-server-optional-rpms)

・ extras リポジトリ (rhel-7-server-extras-rpms)

リポジトリを有効化するには、Red Hat Network Classicのオプションのサブチャンネルを有効にする必要があります。証明書ベース

のサブスクリプションに関する詳細は、Red Hat Subscription Management Guideを参照してください。

サブチャンネルを有効にするために、以下のコマンドを実行します。

subscription-manager repos --enable rhel-7-server-optional-rpms

subscription-manager repos --enable rhel-7-server-extras-rpms

3. EPELをインストールします。

Red Hat Enterprise Linux 7.2のEPELをダウンロードするために、下記のコマンドを実行します。

wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

EPELをインストールするために、以下のコマンドを実行します。

sudo rpm -i epel-release-latest-7.noarch.rpm

4. Ansibleをインストールするために、以下のコマンドを実行します。

sudo yum install ansible1.9

2.1.3 CMMソフトウェアとセットアップユーティリティ

ソフトウェアとセットアップユーティリティはCMM DVD（本製品のインストールメディア）に収録されているCMMインストールパッケージで配布

されています。インストールパッケージをセットアップするには、DVDをマウントし、提供されているsetup.shスクリプトを実行する必要が

あります。setup.shスクリプトを実行するとCMMのインストールに必要なファイル群が配置されます。

下記のとおりに実施してください。


2. DVDを任意のディレクトリにマウントします。ISO9660ファイルシステムを明示的に指定することを推奨します。

以下のコマンドを実行します。

- 7 -

http://docs.ansible.com/ansible/intro_installation.html#control-machine-requirements

https://access.redhat.com/documentation/en-US/Red_Hat_Subscription_Management/1/html/RHSM/entitlements-and-yum.html#supplementary-repos

# mount -t iso9660 -r /dev/<file_name> <mount_dir>

<file_name>をDVDデバイスのファイル名で、<mount_dir>をDVDのマウント先ディレクトリで置き換えてください。

3. setup.shスクリプトを実行するには下記のコマンドを使用します。

# <mount_dir>/setup.sh

<mount_dir>をDVDのマウント先ディレクトリで置き換えます。

インストールパッケージがコントロールマシン上の/opt/FJSVsvcmmディレクトリに展開されます。展開後、以下のファイルとディレクトリが

利用可能となります。

・ group_vars

コントロールマシンの設定に必要となるAnsibleグループ変数を含むディレクトリ。

・ host_vars

コントロールマシンの設定に必要となるAnsibleホスト変数を含むディレクトリ。

・ rolesおよびtasks

CMMインストーラによって要求されるアーティファクトを含むディレクトリ。

・ templates

サンプルのAnsible設定ファイルが格納されているディレクトリ。コントロールマシンの設定に使用できます。

・ uninstaller

CMMアンインストーラによって要求されるアーティファクトを含むディレクトリ。

・ *.ymlファイル

CMMソフトウェアコンポーネントのインストールとアンインストールに必要なAnsibleプレイブック。

・ services.sh

CMMエージェントとサービスの起動、停止、状況確認を行うためのスクリプト。

・ *.txtファイル

CMM11_PythonRequirements.txt は CMM サービスに必要な Python ライブラリの一覧です。

OSP8_PythonRequirements.txtはOpenStackエクステンションに必要なPyhonライブラリの一覧です。これらのライブラリ

は/usr/lib/python2.7/site-packagesディレクトリにインストールされます。

注意

CMMサービスとOpenStackエクステンションの前提条件として、特定バージョンのPythonライブラリをインストールする必要があります。

インストールしたバージョンが/usr/lib/python2.7/site-packagesディレクトリ内で上書きされていないことを確認してくだ

さい。

CMM11_RPMPackages.txtはCMMコンポーネントのインストールに必要なRPM (RedHat Repository Manager)パッケージの一覧

です。OSP8_RPMPackages.txtは、OpenStackエクステンションのインストールに必要なRPMパッケージの一覧です。

注意

CMMインストーラは、不足しているRPMパッケージをYumリポジトリサーバから自動的にインストールします。必要なパッケージがYumリポジトリにあることを確認する必要があります。

2.1.4 セキュリティ

デフォルトのRed　Hat Enterprise Linuxインストールでは、以下が設定されています。

・不正ユーザーアクセスを防止するためにファイアウォールが存在しています。

- 8 -

・必須のアクセス制御メカニズムを追加するセキュリティモジュールであるSELinuxが有効になっています。

CMMコンポーネントのインストールを行う前に、ファイアウォールが有効で、SELinuxが動作中であるか確認してください。ファイアウォー

ルおよびSELinuxがコントロールマシンとリモートマシン間の通信を妨げないことを確認してください。

CMMコンポーネントのインストールに使用するAnsibleインストーラは、以下のポートを開きます。

・ポート8888：インストールに必要なオフラインリソースに使用します。

・ポート5607：ログAPIに使用します。

・ポート8070：モニタリングAPIに使用します。

・ポート5601：Kibanaサーバに使用します。

ポート8081は、ヘルスチェックやスレッドなど、モニタリングAPIによって内部で必要とします。Ansibleインストーラによって使用される

DropWizardフレームワークは、このポートに対する外部アクセスを有効にします。

CMMでは、必要なOpenStackサービスと統合するために下記のポートを使用します。

・ OpenStack Horizonサービスのポート80

・ OpenStack Keystoneサービスのポート5000と35357

ポートへのアクセスを手動で有効化する必要がある場合は以下のコマンドで設定できます。このコマンドは、アクセスの有効化が必要な

ポートごとに行ってください。

firewall-cmd --add-port=<port_number>/tcp

firewall-cmd --permanent --add-port=<port_number>/tcp

<port_number>はポート番号で置き換えてください。

2.1.5 HTTPSサポート

デフォルトでは、CMMコンポーネントではHTTPプロトコルを通信に使用します。さらにセキュアな接続のために、CMMをHTTPSプロト

コルを使用する設定にすることができます。HTTPSプロトコルの使用については、富士通のサポート窓口までお問い合わせください。

2.1.6 Pythonパッケージ

CMMでは、Pythonパッケージをインストールするためにpipを使用します。CMMソフトウェアコンポーネントをインストールする場合、pipV7.0.3は自動的にインストールされます。

注意

CMMのインストール元であるホストマシンにpipがすでにインストールされているかを確認してください。インストールされているpipのバ

ージョンがV7.0.3以外の場合は、インストールが失敗します。

2.1.7 Bashの設定

インストール中にbashスクリプトでsudoコマンドを実行する際に、サービスの起動に失敗する場合があります。これは、/etc/sudoersフ

ァイルにおけるttyの指定が原因の可能性があります。

エラーを回避するために、以下の手順を実施します。

1. 任意のテキストエディタを使用し、sudoersファイルを開きます。

例：

- 9 -

sudo visudo

2. 下記の行が行の先頭に#を加えてコメントアウトしたものであることを確認してください。

#Defaults requiretty

2.2 コントロールマシンの設定

コントロールマシンは、すべてのリモートマシンに接続されている必要があります。コントロールマシンを設定するには、以下の手順を実施

します。


2. 任意のテキストエディタを使用し、Ansible設定ファイルを開きます。

例：

sudo vim /etc/ansible/ansible.cfg

3. ファイル内で、以下のSSH設定を指定します。

[defaults]

transport = ssh

[ssh_connection]

ssh_args = -o ControlMaster=auto -o BatchMode=yes -o ForwardAgent=yes

4. 任意のテキストエディタを使用し、コントロールマシンの設定ファイルを開きます。

例：

sudo vim /etc/ansible/hosts

コントロールマシンの設定の詳細は、Ansible Inventory documentationを参照してください。

5. 設定ファイルに必要なホストを設定します。CMMには、テンプレートとして使えるサンプル設定ファイルが同梱されています。

hosts-single-os.j2

このサンプルは/opt/FJSVsvcmm/templatesディレクトリにあります。

サンプルファイルの内容を、設定ファイルにすべてコピーしてください。

6. 定義された以下のセクションごとに変数を置き換えます。

・ OpenStack Hosts：OpenStackエクステンションをHorizonホストとKeystoneホストにインストールします。

・ Monasca Agent Hosts：CMMメトリックエージェントをHorizonホストとKeystoneホストにインストールします。

・ Monasca Log Agent Hosts：CMMログエージェントをHorizonホストとKeystoneホストにインストールします。

{{ openstack_host }}は、対応するリモートマシンのホスト名または IP アドレスで置き換えてください。

{{ ssh_user_openstack }}はインストールを行うユーザーのユーザー名で置き換えてください。

注意

CMMコンポーネントをインストールするユーザーはパスワードなしでsudoコマンドを実行する権限を持っている必要があります。あ

らかじめsudoの設定を確認してください。

7. コントロールマシンとリモートマシン間の接続を確立するために、Ansible用のSSHキーを生成します。


ssh-keygen -t rsa

- 10 -

http://docs.ansible.com/intro_inventory.html

注意

SSHキーのパスフレーズを指定していた場合は、インストールまたはアンインストールコマンドの実行にssh-agentツールを使用し

てください。

ssh-agentツールは、インストールまたはアンインストール後、必ず停止してください。

8. SSHキーをリモートマシンにコピーするために、以下のコマンドを実行します。このコマンドは、ソフトウェアコンポーネントのインストール

先リモートマシンごとに実行してください。

ssh-copy-id <user_name>@<host_ip>

user_nameはホストにアクセスする際に使用するユーザー名で置き換えてください。host_ipはホスト名またはIPアドレスで置き換

えてください。

リモートマシンへの接続に成功した場合の応答例：

/usr/bin/ssh-copy-id: INFO: attempting to log in with the new key(s), to filter out any that are already installed

/usr/bin/ssh-copy-id: INFO: 1 key(s) remain to be installed -- if you are prompted now it is to install the new keys

<user_name>@<host_ip>'s password:

Number of key(s) added: 1

Now try logging into the machine, with: "ssh '<user_name>@<host_ip>'"

and check to make sure that only the key(s) you wanted were added.

2.3 OpenStackエクステンションのインストール

OpenStackエクステンションをインストールするための前提条件として、CMM管理者はオフラインリソースをインストールしておく必要が

あります。

CMMのOpenStackエクステンションのインストールは、以下の手順で行います。


2. OpenStackエクステンションのインストールに必要なリモートマシンを設定します。インストーラは、設定目的でAnsibleのグループの

変数を使用します。グループ変数は/opt/FJSVsvcmm/group_varsディレクトリにあります。

任意のテキストエディタを使用し、all_groupファイルを開きます。このファイルはメインの構成設定を定義します。

例：

sudo vim /opt/FJSVsvcmm/group_vars/all_group

3. hostsセクションで運用環境のIPアドレスを確認します。

・ offline_host：オフラインリソース

・ monasca_host：CMMサービス

・ keystone_host：OpenStack Keystoneサービス

例：

# hosts

offline_host: 192.168.10.4

monasca_host: 192.168.10.4

keystone_host: 192.168.10.5

4. インストーラはCMMとの連携用にOpenStackユーザーアカウントを作成します。そのため、お使いの環境に合わせて、Keystone

Admin credentialsセクションにOpenStack Keystoneサービスへのアクセス情報を以下のとおり指定します。

例：

- 11 -

# Keystone Admin credentials

keystone_admin_token: ADMIN

keystone_admin: 'admin'

keystone_admin_project: 'admin'

注意

OpenStack Keystoneサービスに対してADMIN認証が無効になっている場合、keystone_admin_token: ADMINを削除する

必要があります。

5. OpenStackエクステンションのインストールに必要なパスワードを設定します。これらのパスワードは、/opt/FJSVsvcmmディレク

トリにあるcredentials.ymlファイルで定義されています。

任意のテキストエディタを使用し、credentials.ymlファイルを開きます。

例：

sudo vim /opt/FJSVsvcmm/credentials.yml

6. ファイル内で以下のパスワードを指定します。

・ keystone_cmm_operator_user_password：CMM管理者のKeystoneへのアクセスに使用します。CMM管理者のユー

ザーアカウントはインストール時に自動的に作成されます。

・ keystone_cmm_agent_password：CMMメトリックエージェントの設定に使用されるユーザーのKeystoneへのアクセスに使

用します。ユーザーアカウントはインストール時に自動的に作成されます。

・ keystone_admin_agent_password：CMMログエージェントの設定に使用されるユーザーのKeystoneへのアクセスに使

用します。ユーザーアカウントはインストール時に自動的に作成されます。

・ keystone_admin_password：adminなど、既存のOpenStackユーザーアカウントのパスワードです。このユーザーアカウ

ントは、インストール時の新規ユーザーアカウントの作成に使用します。このユーザーアカウントは、OpenStack運用者のアカウ

ントです。

7. OpenStack Keystoneサービスのリージョン名を指定します。リージョン名は/opt/FJSVsvcmm/roles/monasca-keystone/

defaults/main.ymlファイルのkeystone_regionパラメーターで定義されています。

任意のテキストエディタを使用し、main.ymlファイルを開きます。

例：

sudo vim /opt/FJSVsvcmm/roles/monasca-keystone/defaults/main.yml

8. ファイルのkeystone_regionパラメーターを環境に合うよう修正します。

例：

keystone_region: RegionOne

9. OpenStackエクステンションのインストールには、特定の構成設定が必要です。それらの設定は、group_vars/

openstack_groupファイルで指定されています。

ファイルには、デフォルトの設定が含まれています。変更は不要です。

注意

デフォルトとは異なる設定が必要な場合にのみ変更してください。

デフォルトの設定を表示したい場合は、任意のテキストエディタを使用してファイルを開くことができます。

例：

sudo vim /opt/FJSVsvcmm/group_vars/openstack_group

- 12 -

デフォルトで、インストーラは以下のユーザー、ロール、プロジェクトをOpenStackに作成します。

・ CMMをモニタリングするCMM管理者。

ユーザー名：cmm-operator。割り当てられるユーザーロール：cmm-userとadmin。割り当てられるOpenStackプロジェクト：

cmm。

・ CMMメトリックエージェントの設定用ユーザー。このユーザーアカウントは、エージェント設定目的のみに使用し、実際にサー

ビスをモニタリングする際には使用しないことを推奨します。

ユーザー名：cmm-agent。割り当てられるユーザーロール：cmm-agent。割り当てられるOpenStackプロジェクト：cmm。

・ CMMログエージェントの設定用ユーザー。このユーザーアカウントは、エージェント設定目的のみに使用し、CMMでログ管理

機能に実際にアクセスする際には使用しないことを推奨します。

ユーザー名：admin-agent。割り当てられるユーザーロール：cmm-agent。割り当てられるOpenStackプロジェクト：admin。

・ OpenStackプラットフォームをモニタリングするOpenStack運用者このユーザーアカウントは既存のadminユーザーアカウントを使

用します。

割り当てられるユーザーロール：cmm-user。割り当てられるOpenStackプロジェクト：admin。

注意

インストーラによって作成されるロールは、CMMへアクセスする権限を与えられている必要があります。ユーザーアカウントのデフォルト

設定を変更する場合はCMM管理者にお問い合わせください。管理者がCMMサービスを設定します。

10. OpenStackエクステンションをインストールするために、以下のコマンドを実行します。

ansible-playbook /opt/FJSVsvcmm/openstack.yml

インストールに成功した場合、以下の応答が表示されます。

例：

PLAY RECAP ********************************************************

horizon-node : ok=34 changed=21 unreachable=0 failed=0

keystone-node : ok=21 changed=3 unreachable=0 failed=0

注意

インストール中に行われるチェックには、エラーや警告を表示するものがあります。これらのエラーや警告の報告によってインストールが

中止されることはありません。インストールの結果は、最後に表示されるメッセージで確認してください。

インストールに失敗した場合は構成設定およびパスワードを確認し、verboseモードで再度インストールを試みてください。デバッグ情報を

収集するには、以下のコマンドを実行してください。

ansible-playbook -vvvv /opt/FJSVsvcmm/openstack.yml

OpenStackエクステンションのインストール後、CMM管理者はCMMサービスをインストールすることができます。

CMMサービスのインストール後、OpenStackプラットフォームをモニタリングするためのエージェントのインストールおよび設定を行うこと

ができます。

2.4 CMMメトリックエージェントのインストール

OpenStackプラットフォームをモニタリングするためには、CMMメトリックエージェントを、監視するOpenStackノードごとにインストールする


エージェントをインストールするための前提条件として、オフラインリソース、OpenStackエクステンション、およびCMMサービスをインス

トールしておく必要があります。

下記の手順でインストールを実施します。

- 13 -

1. エージェントをインストールします。

2. エージェントの設定を行います。

2.4.1 インストール

CMMメトリックエージェントのインストールは、以下の手順で行います。



例：


3. エージェントをインストールするホストを設定します。そのため、設定ファイルの以下のセクションを確認します。

# Monasca Agent Hosts

[monasca_agent_group]

horizon-monasca-agent ansible_ssh_host=<horizon_host> ansible_ssh_user=<ssh_user_monasca>

keystone-monasca-agent ansible_ssh_host=<keystone_host> ansible_ssh_user=<ssh_user_monasca>

別のホストに追加でエージェントをインストールする場合は、行を追加して設定することもできます。これにより、一度に１つまたは複数

のインスタンスにエージェントをインストールすることが可能です。行を追加する場合、エージェントをインストールするホストマシン用に

一意のエイリアスを指定する必要があります。

4. ホスト変数を、エージェントのインストール先リモートマシンのホスト名またはIPアドレスで置き換えます。<ssh_user_monasca>は

インストールを行うユーザーのユーザー名で置き換えます。

注意

エージェントをインストールするユーザーは、インストール先のホストマシンにアクセスできる必要があります。root権限を持つユー

ザーとしてアクセスする必要があります。



ssh-keygen -t rsa

6. SSHキーをリモートマシンにコピーするために、以下のコマンドを実行します。このコマンドは、エージェントをインストールするリモ

ートマシンごとに実行してください。

ssh-copy-id <user_name>@<host_ip_address>

<user_name>はホストにアクセスする際に使用するユーザー名で置き換えてください。<host_ip_address>はホスト名またはIP

アドレスで置き換えてください。




<user_name>@<host_ip_address>'s password:


Now try logging into the machine, with: "ssh '<user_name>@<host_ip_address>'"


7. 設定ファイルをエージェントごとに作成します。設定ファイルはインストールディレクトリに格納する必要があります。設定ファイルは

インストールするインスタンスごとに個別に必要です。

- 14 -

設定ファイルを作成するには以下のコマンドを実行します。このコマンドは、エージェントのインストール先リモートマシンごとに実行

してください。

sudo vim /opt/FJSVsvcmm/host_vars/<file_name>

<file_name>はホストマシンのエイリアスで置き換えてください。<file_name>はコントロールマシンの設定ファイルで指定さ

れているエイリアスと同一でなければなりません（前述のステップ３を参照）。

8. エージェントを設定します。以下のサンプルは、エージェントを起動するために必要な最低限のパラメーターを示しています。必要

最低限のパラメーターはCMMサービスとエージェント間の通信に使用されるOpenStackユーザーの認証情報です。

必要に応じて追加の構成設定を指定することができます。利用できる構成設定の一覧については、A.1 CMMメトリックエージェントの

構成設定を参照してください。

必要最低限のパラメーターを定義するには、以下の内容を各設定ファイルに挿入します。モニタリングデータをCMMサービスへ送信

する権限が与えられている有効なOpenStackユーザーの認証情報を指定してください。

例：

# file: host_vars/horizon-monasca-agent

# Monasca Agent user credentials

monasca_agent_user: cmm-agent

monasca_agent_password: "{{ openstack_monasca_agent_keystone_password }}"

monasca_agent_project: cmm

9. エージェントのインストールに必要なパスワードを設定します。パスワードは、/opt/FJSVsvcmmディレクトリにある

credentials.ymlファイルで定義されています。


例：



・ openstack_monasca_agent_keystone_password：OpenStackホスト上のCMMメトリックエージェントの設定目的で使

用されるユーザーのKeystoneへのアクセスに使用します。ユーザーアカウントはインストール時に自動的に作成されます。

・ Maria DBデータベースへのエージェントアクセスのためのcmm_monasca_agent_database_password

・ cmm_monasca_agent_keystone_password：CMMホスト上のCMMメトリックエージェントの設定目的で使用されるユー

ザーのKeystoneへのアクセスに使用します。ユーザーアカウントはインストール時に自動的に作成されます。

11. インストールを実行するには下記のコマンドを使用します。

ansible-playbook /opt/FJSVsvcmm/monasca-agent.yml


例：

PLAY RECAP ********************************************************

monasca-agent : ok=40 changed=23 unreachable=0 failed=0

注意





ansible-playbook -vvvv /opt/FJSVsvcmm/monasca-agent.yml

- 15 -

インストールに成功すると、エージェントは自動的に起動します。インストーラは、マシンの起動時にエージェントを自動的に起動する起動

スクリプトを作成します。

CMMメトリックエージェントはvirtualenv環境にインストールされます。デフォルトでは、CMMメトリックエージェントのvirtualenv環境は/opt/

monasca-agentディレクトリにあります。

エージェントは、LINUXサービスとして提供されます。

2.4.2 設定

エージェントのインストール時、エージェントをインストールするサーバ上にモニタリングに必要な設定ファイルを作成します。設定ファイ

ルは、.yaml形式です。作成される設定ファイルは以下のとおりです。

・ /etc/monasca/agentディレクトリに格納されているagent.yaml

エージェントの基本構成を定義します。インストーラはマシン上で動作中のアプリケーションおよびプロセスを自動的に検知し、それに

対応する設定をこのファイルに保存します。

・ /etc/monasca/agent/conf.dディレクトリに格納されている*.yaml

これらの設定ファイルでエージェントがサービスやサーバのモニタリングに使用する標準メトリックを提供します。システムチェック用の

標準メトリックはインストーラが自動的に設定します。

・ /opt/monasca-agent/share/monasca/agent/conf.dディレクトリに格納されている*.yaml

これらの設定ファイルを有効化することで、標準メトリックに拡張して追加メトリックを提供します。これらのファイルには、追加メトリックを

設定するためのテンプレートが定義されています。

エージェントのインストールには初期設定が含まれています。エージェントの設定変更は以下の方法で行うことができます。

・ agent.yamlファイルを更新することができます。

・標準メトリックに加え、追加のメトリックを有効化することができます。

詳細については、下記を参照してください。

設定ファイルの更新

agent.yamlファイルの編集は以下の手順で行います。

1. エージェントをインストールしたサーバにログインします。

2. エージェントを停止するために、以下のコマンドを実行します。

sudo systemctl stop monasca-agent

3. 任意のテキストエディタを使用し、ファイルを開きます。

例：

sudo vim /etc/monasca/agent/agent.yaml

4. 必要に応じて設定値を修正します。

CMMで利用できるパラメーターの一覧を確認するには、A.1 CMMメトリックエージェントの構成設定を参照してください。

5. エージェントを再度起動するために、以下のコマンドを実行します。

sudo systemctl start monasca-agent

エージェントは更新された設定値を使って即座に利用可能です。

追加メトリックの有効化

インストーラは、サービスとサーバをモニタリングするための標準メトリックを自動的に有効化します。標準メトリックには、CPU使用量、ディスク

領域、システムの平均負荷などのシステムチェックが含まれます。これらのシステムチェックを手動で設定する必要はありません。インス

トーラによって、エージェントのインストール先サーバからモニタリングデータを取得するよう、自動的に設定されます。これらのメトリック

については、B.1 標準メトリックを参照してください。

- 16 -

CMMでは、標準メトリックの拡張として、追加メトリックの有効化ができます。CMMがサポートするメトリックの一覧については、B.2 追加メ

トリックを参照して下さい。

エージェントには、環境に合うよう修正したり、サービスやサーバのモニタリングに使用したりできるメトリックテンプレートが同梱されてい

ます。

追加メトリックの有効化は、以下の手順で行います。




3. 必要なテンプレートファイルをコピーします。

例：

sudo cp -p \

/opt/monasca-agent/share/monasca/agent/conf.d/rabbitmq.yaml.example \

/etc/monasca/agent/conf.d/rabbitmq.yaml

4. 任意のテキストエディタを使用し、テンプレートファイルを開きます。

例：

sudo vim /etc/monasca/agent/conf.d/rabbitmq.yaml

5. 設定を実際の環境に合うよう修正します。設定例については、B.2 追加メトリックを参照してください。



有効化されたメトリックは、エージェントがモニタリングデータを取得するために即座に利用できます。

注意

インストーラは、システム上で動作中のアプリケーションおよびプロセスを自動的に検知し、検知した設定値を対応する設定ファイルに保存

します（host_alive.yaml、http_check.yaml、process.yamlなど）。これらのファイルは、自動的に/etc/monasca/

agent/conf.d/ディレクトリに格納されます。あらかじめ、設定値を確認してください。

2.5 CMMログエージェントのインストール

OpenStackプラットフォームをモニタリングするためには、CMMログエージェントを、監視するOpenStackノードごとにインストールする必要

があります。

エージェントをインストールするための前提条件として、オフラインリソース、OpenStackエクステンション、およびCMMサービスをインス

トールしておく必要があります。

下記の手順でインストールを実施します。

1. エージェントをインストールします。

2. エージェントの設定を行います。

2.5.1 インストール

CMMログエージェントのインストールは、以下の手順で行います。



- 17 -

例：


3. エージェントをインストールするホストを設定します。そのため、設定ファイルの以下のセクションを確認します。

# Monasca Log Agent Hosts

[monasca_log_agent_group]

horizon-monasca-log-agent ansible_ssh_host=<horizon_host> ansible_ssh_user=<ssh_user_monasca>

keystone-monasca-log-agent ansible_ssh_host=<keystone_host> ansible_ssh_user=<ssh_user_monasca>

別のホストに追加でエージェントをインストールする場合は、行を追加して設定することもできます。これにより、一度に１つまたは複数

のインスタンスにエージェントをインストールすることが可能です。行を追加する場合、エージェントをインストールするホストマシン用に

一意のエイリアスを指定する必要があります。

4. ホスト変数を、エージェントのインストール先リモートマシンのホスト名またはIPアドレスで置き換えます。<ssh_user_monasca>は

インストールを行うユーザーのユーザー名で置き換えます。

注意

エージェントをインストールするユーザーは、インストール先のホストマシンにアクセスできる必要があります。root権限を持つユー

ザーとしてアクセスする必要があります。



ssh-keygen -t rsa

6. SSHキーをリモートマシンにコピーするために、以下のコマンドを実行します。このコマンドは、エージェントをインストールするリモ

ートマシンごとに実行してください。

ssh-copy-id <user_name>@<host_ip_address>

<user_name>はホストにアクセスする際に使用するユーザー名で置き換えてください。<host_ip_address>はホスト名またはIP

アドレスで置き換えてください。




<user_name>@<host_ip_address>'s password:


Now try logging into the machine, with: "ssh '<user_name>@<host_ip_address>'"


7. 設定ファイルをエージェントごとに作成します。設定ファイルはインストールディレクトリに格納する必要があります。設定ファイルは

インストールするインスタンスごとに個別に必要です。

設定ファイルを作成するには以下のコマンドを実行します。このコマンドは、エージェントのインストール先リモートマシンごとに実行


sudo vim /opt/FJSVsvcmm/host_vars/<file_name>

<file_name>はホストマシンのエイリアスで置き換えてください。<file_name>はコントロールマシンの設定ファイルで指定さ

れているエイリアスと同一でなければなりません（前述のステップ３を参照）。

8. エージェントを設定します。以下のサンプルは、エージェントを起動するために必要な最低限のパラメーターを示しています。必要

最低限のパラメーターはCMMサービスとエージェント間の通信に使用されるOpenStackユーザーの認証情報です。

必要に応じて追加の構成設定を指定することができます。構成設定の詳細については、A.2 CMMログエージェントの構成設定を参照


- 18 -

必要最低限のパラメーターを定義するには、以下の内容を各設定ファイルに挿入します。ユーザーの認証情報を、モニタリングデ

ータをCMMサービスに送信する権限が与えられているOpenStackユーザーの認証情報で置き換えてください。

例：

# file: host_vars/cmm-monasca-log-agent

# logstash monasca user credentials

project_name: cmm

username: cmm-operator

password: "{{ openstack_monasca_log_agent_keystone_password }}"

domain_id: default

注意

インストール時、最小セットのログデータが即座に取得できるようエージェントを自動的に設定します。この設定の更新方法につい

ては、2.5.2 設定を参照してください。

9. エージェントのインストールに必要なパスワードを設定します。パスワードは、/opt/FJSVsvcmmディレクトリにある

credentials.ymlファイルで定義されています。


例：



・ openstack_monasca_log_agent_keystone_password：OpenStackホスト上のCMMログエージェントの設定目的で

使用されるユーザーのKeystoneへのアクセスに使用します。ユーザーアカウントはインストール時に自動的に作成されます。

・ cmm_monasca_log_agent_keystone_password：CMMホスト上のCMMログエージェントの設定で使用されるユーザ

ーがKeystoneにアクセスする際に使用します。ユーザーアカウントはインストール時に自動的に作成されます。

11. インストールを実行するには下記のコマンドを使用します。

ansible-playbook /opt/FJSVsvcmm/monasca-log-agent.yml


例：

PLAY RECAP ********************************************************

monasca-log-agent : ok=40 changed=23 unreachable=0 failed=0

注意





ansible-playbook -vvvv /opt/FJSVsvcmm/monasca-log-agent.yml

インストールに成功すると、エージェントは自動的に起動します。インストーラは、マシンの起動時にエージェントを自動的に起動する起動

スクリプトを作成します。

エージェントは、LINUXサービスとして提供されます。

2.5.2 設定

- 19 -

エージェントのインストール時、最小限のログデータが即座に取得できるようエージェントを自動的に設定します。必要に応じエージェント設定の変更や初期設定の更新が可能です。

後述のセクションでは、エージェントの設定を格納している設定ファイルについて、また、設定を更新する方法について説明します。

設定ファイル

インストーラはCMMログエージェントのすべての構成設定を以下のファイルに格納します。

/etc/monasca/monasca-log-agent/agent.conf

このファイルは入力セクションと出力セクションで構成されています。

・入力セクションは、取得するログデータを指定します。

CMMログエージェントは、オープンソースプロジェクトのElasticsearch、Logstash、Kibanaを組み合わせたログデータの検索および解析

ソリューションである、ELKスタックに基づいています。ELKスタックの詳細については、Elasticsearch、Logstash、およびKibanaの資料を

参照してください。

CMMは、入力メカニズムとして、Logstashのファイルプラグインをサポートしています。ファイルプラグインは、Logstashがファイルシステム

上のログファイルからログデータを読み取ることができるようにします。詳細は、Logstash Input Pluginsを参照してください。CMMを別

のプラグインと統合させたい場合は富士通までお問い合わせください。

・出力セクションは、ログデータを取得し、その後の処理のためにCMMサーバに送信するために必要なパラメーターをすべて指定し

ます。

設定ファイルの更新

agent.confファイルの編集は以下の手順で行います。



sudo systemctl stop monasca-log-agent

3. 任意のテキストエディタを使用し、ファイルを開きます。

例：

sudo vim /etc/monasca/monasca-log-agent/agent.conf

4. 必要に応じて入力セクションを修正します。

モニタリングするファイルを追加したい場合は、対応するfileブロックを追加してください。

fileブロックのログファイルにディメンションを定義したい場合、add_fieldで定義してください。ディメンションで、エージェントが取得

したログデータのメタ情報を収集できます。メタ情報は各ログエントリに付加されます。これは、CMMログ管理ダッシュボードのフィ

ールドとして表示されます。ログデータを操作しているユーザーは、ディメンションをフィルタリングオプションとして使用できます。

設定例：

input {

file {

path => "/var/log/keystone/*.log"

}

file {

path => "/var/log/monasca/agent/*.log"

}

file {

path => "/var/log/monasca/monasca-log-agent/*.log"

}

file {

add_field => { "dimensions" => { "service" => "monasca-api" }}

add_field => { "dimensions" => { "language" => "java" }}

add_field => { "dimensions" => { "log_level" => "error" }}

path => "/var/log/monasca/api/error.log"

- 20 -

https://www.elastic.co/guide/index.html

https://www.elastic.co/guide/en/logstash/2.2/input-plugins.html

}

}

5. 必要に応じて出力セクションを修正してください。対応するパラメーター値を更新してください。各値はダブルクォーテーション（"）で囲

む必要があります。

定義可能な設定値に関する詳細は、A.2 CMMログエージェントの構成設定を参照してください。

設定例：

output {

monasca_log_api {

monasca_log_api_url => "http://192.168.10.4:5607/v3.0"

keystone_api_url => "http://192.168.10.5:35357/v3"

project_name => "cmm"

username => "cmm-operator"

password => "password"

domain_id => "default"

dimensions => ['app_type:kafka', 'priority:high']

num_of_logs => 100

delay => 1

elapsed_time_sec => 600

max_data_size_kb => 5120

}

}


sudo systemctl start monasca-log-agent

エージェントは更新された設定値を使って即座に利用可能です。

2.6 運用と保守

通常の運用と保守には、以下の作業が含まれます。

・エージェントの起動と停止

・ CMMメトリックエージェントの設定における特定メトリックのモニタリングの無効化。

・ CMMログエージェントの設定における特定ログデータの収集の無効化。

・エージェントログファイルの収集

・バックアップとリカバリ

2.6.1 エージェントの起動と停止

システムの操作および保守の際、手動によるエージェントの停止と再起動が必要になる場合があります。

エージェントの起動は以下の手順で行います。


2. CMMメトリックエージェントを起動するために、以下のコマンドを実行します。


CMMログエージェントを起動するために、以下のコマンドを実行します。


エージェントの停止は以下の手順で行います。


- 21 -

2. CMMメトリックエージェントを停止するために、以下のコマンドを実行します。


CMMログエージェントを停止するために、以下のコマンドを実行します。


2.6.2 CMMメトリックエージェントのメトリックの無効化

CMMメトリックエージェントの構成において不要になった特定のメトリックを無効にするには、対応する.yamlファイルを削除しなければ

なりません。以下の手順を行ってください。




3. モニタリングに使用しているメトリックの格納先ディレクトリに移動します。

例：

cd /etc/monasca/agent/conf.d

4. モニタリングに不要になった.yamlファイルを削除します。

例：

sudo rm -i process.yaml



2.6.3 CMMログエージェントのログデータの無効化

CMMログエージェントの構成において不要になったのログデータのモニタリングを無効にするには、対応するagent.conf設定ファ

イルから対応するエントリを削除しなければなりません。以下の手順を行ってください。




3. 任意のテキストエディタを使用し、エージェント設定ファイルを開きます。

例：

sudo vim /etc/monasca/monasca-log-agent/agent.conf

4. inputセクションで、モニタリングする必要がなくなったログデータのfileブロックを削除します。

例えば、Keystone上のログデータをモニタリングする必要がなくなった場合は、以下のfileブロックを削除します。

file {

path => "/var/log/keystone/*.log"

}



- 22 -

2.6.4 エージェントログファイルの収集

エージェントのログファイルには、エージェントの運用中に発生したイベントが記録されます。CMMでは、エージェントコンポーネント単位

のログファイルを提供しています。ログファイルは、トラブルシューティングを行う場合などに重要な情報を提供します。

CMMメトリックエージェントのログファイルは以下のディレクトリに出力されます。

/var/log/monasca/agent

CMMログエージェントのログファイルは以下のディレクトリに出力されます。

/var/log/monasca/monasca-log-agent

2.6.5 バックアップとリカバリ

CMMでは、統合されたバックアップとリカバリ機能は提供していません。標準のファイルシステムメカニズムを使用してください。

設定ファイルは定期的にバックアップすることを推奨します。

・ /etc/monasca/agentディレクトリにあるCMMメトリックエージェントの設定ファイル。

・ /etc/monasca/monasca-log-agentディレクトリにあるCMMログエージェントの設定ファイル。

バックアップ頻度は、設定の変更量に依存します。

エージェントインストールの復旧が必要になった場合に推奨する手順は以下のとおりです。

1. エージェントをアンインストールします。詳細は、2.7 アンインストールを参照してください。

2. エージェントを再インストールします。CMMメトリックエージェントに関する詳細は、2.4.1 インストールを参照してください。CMMロ

グエージェントに関する詳細は、2.5.1 インストールを参照してください。

3. エージェントを停止します。

4. 設定ファイルのバックアップを、それぞれ、/etc/monasca/agentディレクトリまたは/etc/monasca/monasca-log-agent

ディレクトリにコピーします。

5. エージェントを再起動します。

2.7 アンインストール

OpenStack運用者は、必要に応じて、CMMエージェントをアンインストールします。OpenStackエクステンションは、CMMサービスをアン

インストールするCMM管理者によってアンインストールされます。

CMMエージェントのアンインストールを行う前に、運用目的で作成した設定ファイルのバックアップを作成しておくことを推奨します。バ

ックアップに関する詳細は、2.6.5 バックアップとリカバリを参照してください。

CMMメトリックエージェントまたはCMMログエージェントのアンインストールは、以下の手順で行います。



例：


3. アンインストールするエージェントのホストが正しく設定されているか確認します。ファイル内で複数のホストが指定されている場合、

複数インスタンスのエージェントがアンインストールされます。

リモートマシンのホスト名またはIPアドレスおよびエージェントのアンインストールを行うユーザーのユーザー名を指定する必要が

あります。

- 23 -

注意

エージェントをアンインストールするユーザーは、対応するホストにアクセスできる必要があります。root権限を持つユーザーとして

アクセスする必要があります。

4. １つまたは複数のインスタンスのCMMメトリックエージェントのアンインストールを行うために、以下のコマンドを実行します。

ansible-playbook /opt/FJSVsvcmm/monasca-agent-uninstaller.yml

１つまたは複数のインスタンスのCMMログエージェントのアンインストールを行うために、以下のコマンドを実行します。

ansible-playbook /opt/FJSVsvcmm/monasca-log-agent-uninstaller.yml

エージェントのアンインストールでは、以下が実施されます。

・エージェントが停止されます。

・対応するサービスが削除されます（monasca-agentまたはmonasca-log-agent）。

・エージェントの設定ファイルとそれらの格納先ディレクトリが削除されます。

- 24 -

第3章テナントユーザーのための準備

OpenStackで仮想マシンを配備するテナントユーザーはlibvirtを使用してマシンをモニタリングできます。libvirtは仮想マシンの管理の

ためのツールキットを提供します。

OpenStack運用者は、テナントユーザー向けのモニタリング環境を準備する必要があります。以下の手順を実施します。

1. OpenStackでlibvirt モニタリングに使用するロールとユーザーアカウントの作成。

2. テナントユーザーの仮想マシンが配備されているハイパーバイザー上へのCMMメトリックエージェントのインストール。

3. libvirtモニタリング用の追加のライブラリのインストール。

4. エージェントの設定。

3.1 OpenStackにおけるロールとユーザーアカウントの作成

CMMメトリックエージェントをインストールするための前提条件として、以下の手順を実施する必要があります。

・ OpenStack Keystoneにmonitoring-delegateロールを作成します。

このロールは、クロステナントメトリックの送信に必要となります。テナントユーザーは、自分の仮想マシンに関連しているモニタリング

データだけを受け取る必要があります。このロールにより、エージェントは、個々のテナントユーザーの代理としてメトリックを送信す

ることができます。

・エージェント設定用のユーザーアカウントを作成します。このユーザーにはmonitoring-delegateロールが割り当てられている


このユーザーのユーザー名とパスワードは、エージェントのインストール時に行うエージェント設定で指定します。このユーザーアカ

ウントは、設定目的のみに利用し、実際にサービスをモニタリングする際には使用しないことを推奨します。

3.2 CMMメトリックエージェントのインストール

テナントユーザー用のモニタリングを有効にするには、テナントユーザーの仮想マシンをホストしているハイパーバイザーにCMMメトリ

ックエージェントをインストールしておく必要があります。

エージェント設定でlibvirtモニタリング用に作成したOpenStackユーザーの認証情報を入力します。このユーザーは、CMMサービスとエ

ージェント間の通信に使用されます。

CMMメトリックエージェントのインストールに関する詳細は、2.4.1 インストールを参照してください。

3.3 追加のライブラリのインストール

libvirtモニタリングには、追加のRPMパッケージとPythonライブラリが必要です。

以下のRPMパッケージをYumリポジトリサーバからインストールします。

・ libvirt-devel

以下のPythonライブラリをCMMメトリックエージェントのvirtualenv環境にインストールします。

・ libvirt-python

・ lxml

・ python-neutronclient

・ python-novaclient。バージョン2.26が必要です。

デフォルトでは、CMMメトリックエージェントのvirtualenv環境は/opt/monasca-agentディレクトリにあります。

- 25 -

3.4 CMMメトリックエージェントの設定

CMMメトリックエージェントのインストールには初期設定が含まれています。テナントユーザー用の環境を準備するには、エージェントの設定

を変更する必要があります。テナントユーザーがモニタリングに使用するlibvirtメトリックを有効化する必要があります。Libvirtのチェックは、

ハイパーバイザー上で動作する仮想マシンのメトリックを送信します。このチェックは、ハイパーバイザーのオーナーだけでなく、仮想マ

シンのオーナーにもメトリックを送信します。

メトリックを有効化する方法については、2.4.2 設定を参照してください。設定例については、B.2 追加メトリックを参照してください。

エージェントが再起動され次第、テナントユーザーはlibvirtメトリックをモニタリングに使用できるようになります。

- 26 -

第4章サービスおよびサーバのモニタリング

サービスとサービスが提供されるサーバをモニタリングするため、CMMは以下のようなさまざまな機能を提供します。

・複数のサービスとサーバを継続的に追跡し、その状態を素早くチェックできるモニタリング概要ページ。

・モニタリングデータを可視化するメトリックダッシュボード。

・アラーム機能。

次のセクションでは、モニタリング概要や統合されたメトリックダッシュボードのほか、アラームや通知の定義および対処方法についても説明

します。

CMMへのアクセス

モニタリングを実施するためには、cmm-userロール、またはCMMモニタリング機能を使用する権限を与えられているその他のロールを持

つユーザーとしてOpenStackプラットフォームにアクセスできる必要があります。ロールの追加は任意です。また、モニタリングしたい

OpenStackプロジェクトに割り当てられていることが条件となります。

該当ユーザーの認証情報を使ってOpenStackプラットフォームへログインします。これにより、OpenStack Horizonダッシュボードにアクセ

スすることができます。CMM機能は、[モニタリング]タブ上で利用できます。割り当てられているプロジェクトのすべてのモニタリングデー

タにアクセスできます。

4.1 サービスおよびサーバの概要

CMMは、サービスとサーバの分かりやすいステータス概要を提供します。[モニタリング] > [概要]により、ステータスが一目で分かります。

[概要]ページで、エージェントが取得したすべてのモニタリングデータにアクセスできます。[概要]ページ最上部のオプションを使用して、

事前に設定済みのCMMメトリックダッシュボードにアクセスできます。必要に応じて、モニタリングデータを可視化する独自のダッシュボ

ードも作成可能です。詳細は、4.2 モニタリングデータの可視化を参照してください。

サービスとサーバのアラームを定義すると、[概要]ページにステータス情報が表示されます。

・緑色の枠で示されたサービスおよびサーバは、動作中であることを示します。アラームは定義されていますが、しきい値を超えてい

ません。

・赤色の枠で示されたサービスあるいはサーバは、確認が必要な深刻な問題があることを示します。サービスあるいはサーバに定義さ

れている１つもしくは複数のアラームが発生しています。

・黄色の枠で示されたサービスあるいはサーバは、問題が発生していることを示します。すでに１つあるいは複数のアラームが発生し

ていますが、これらの深刻度は低いです。

・灰色の枠で示されたサービスあるいはサーバは、アラームが定義されていますが、モニタリングデータはまだ採取および送信されて

いません。

アラームの定義に関する詳細は、4.3 アラームの定義を参照してください。

4.2 モニタリングデータの可視化

サービスおよびサーバをモニタリングするためのユーザーインターフェースは、メトリックダッシュボード上で大規模のモニタリングデータを

可視化するオープンソースアプリケーションであるGrafanaと連携しています。CMMは、事前に定義された管理者向けのメトリックダッシ

ュボード機能を提供します。必要に応じ独自のダッシュボードを設定することもできます。

各メトリックダッシュボードは、複数の行内に配置された個々のパネルで構成されます。どのコンテンツをどこのパネルに表示するか、ま

たどの時間範囲を可視化するかを決めることができます。パネルは、行内、または別の行へドラッグアンドドロップすることができます。追加の

表示オプションにより、コンテンツの表示形式もカスタマイズすることができます。

独自のダッシュボード作成のほか、CMMではメトリックダッシュボードをエクスポートおよびインポートすることができます。また、容易に

カスタマイズできるよう、メトリックダッシュボードのテンプレートを作成して保存することもできます。

- 27 -

メトリックダッシュボードのパネル編集ユーザーインターフェースを使った操作については、GrafanaのGetting Startedのチュートリアルを参照


OpenStack Horizonダッシュボードの[モニタリング] > [概要]を使用してCMMメトリックダッシュボードにアクセスしてください。[概要]ページ

最上部のボタンを使用して、事前に定義されたダッシュボードにアクセスできます。必要であれば、ダッシュボードをカスタマイズして、自分の

見たいデータを可視化できます。

4.3 アラームの定義

CMMでは、クラウドリソースをモニタリングするためのアラームを定義することができます。アラーム定義では、収集するメトリックとアラームが

発生するしきい値を指定します。クラウドリソースが指定されたしきい値に到達あるいは超える場合、通知をCMM利用者に送信します。

多様なモニタリング要件に対処するため、簡易または複雑なアラーム定義を作成することができます。アラーム定義の構文は、シンプルな

記述でさまざまな条件を表現できる文法をベースにしています。

アラーム定義では、下記の要素を指定します。

・ [名前]：アラームの必須識別子。アラームを定義するプロジェクト内で一意な値にする必要があります。

・ [条件式]：アラームを定義する部分式および論理演算子。この条件式の結果が真の場合、アラームが発生します。

条件式の定義は、以下の手順で行います。

1. モニタリングするメトリックを選択してください。選択リストから、OpenStack運用者によって提供されたすべてのメトリックにアクセ

スできます。

2. メトリックの統計関数を後述から選択してください。最低値をモニタリングするmin、最大値をモニタリングするmax、合計値をモ

ニタリングするsum、モニタリングした値のcount、あるいは算術平均のavg。

3. 1つもしくは複数のディメンションを[ディメンションの追加]フィールドに入力して、メトリックの精度を高めます。

指定したディメンションはモニタリング対象を絞り込みます。各ディメンションは、キーと値のペアから構成されます。キーと値には、

例えば、リージョン、アベイラビリティーゾーン、サービス層、リソースIDなどを使用して、モニタリングしたいデータを柔軟かつ簡潔に

記述できます。

選択したメトリックに利用できるディメンションは、[Matching Metrics]セクションに表示されます。メトリックに関連づけるキーの名前

を[ディメンションの追加]フィールドに入力します。必要なキーと値のペアを追加するための選択リストが表示されます。

4. アラームが発生するしきい値を入力し、メトリックとしきい値を関係演算子で結び付けます。演算子は<、>、<=、>=から選択し

ます。

しきい値の単位は、選択したメトリックに連動します。例えば、cpu.system_percの単位はパーセントで、

disk.total_used_space_mbの単位はMBです。

注意

より複雑なアラーム定義が必要な場合、アラーム定義を作成し、そのアラーム定義を更新してください。[アラーム定義の編集]ページで、

条件式の構文を直接編集することができます。

・ [マッチ]：アラームの発生に考慮が必要なディメンションを入力します。評価される条件式内のディメンションを無視したい場合は、何も

入力しないでください。

・ [説明]：省略可。アラーム定義の説明。

・ [重大度]：アラームの重大度。重大度は[Low]、[Medium]、[High]あるいは[Critical]から選択します。

重大度は[概要]タブなどのステータス情報の色に反映されます。[Critical]に定義されているアラームが発生すると、対応するリソースが

赤色の枠で表示されます。[Low]、[Medium]、[High]に定義されているアラームが発生すると、対応するリソースは黄色の枠で表示さ

れます。

重大度のレベルはユーザーの主観で決定できます。アラームの優先度に適したレベルを選択してください。

・ [通知]：省略可。アラームに使用される警報。アラームが発生すると、選択した通知が送信されます。

選択可能な通知項目は、事前に定義しておく必要があります。詳細については、4.4 通知の定義を参照してください。

- 28 -

http://docs.grafana.org/v1.9/guides/gettingstarted/

アラーム定義に関する詳細は、Monasca API documentationを参照してください。

アラームの作成、編集、削除は、[モニタリング] > [アラーム定義]から実施してください。

4.4 通知の定義

通知は、アラームに定義されたしきい値に到達するか、またはそれを超えた場合にCMM利用者にそのことを知らせる方法を定義します。

アラーム定義では、１つ以上の通知を割り当てることができます。

通知には、下記の要素を指定します。

・ [名前]：通知の一意の識別子。アラーム定義時の選択肢として使用される名前。

・ [タイプ]：EmailはCMMがサポートする通知方法です。WebHookまたはPagerDutyの使用については、富士通のサポート窓口ま

でお問い合わせください。

・ [アドレス]：アラームが発生した場合に送信される通知の送信先メールアドレス。

注意

ビジネスドメイン名など、ジェネリックトップレベルドメインは、電子メールアドレスに指定できません（[email protected]など）。

通知の作成、編集、削除は、[モニタリング] > [通知]から実施してください。

- 29 -

https://github.com/openstack/monasca-api/blob/stable/mitaka/docs/monasca-api-spec.md

第5章ログデータの管理

提供するサービスおよび仮想サーバや物理サーバのログデータを管理するため、CMMはログ管理ダッシュボードを提供します。ダッシ

ュボードは、ログデータを可視化または分析するためのオプションを提供します。

CMMログエージェントで取得したログデータにアクセスするには、インデックスパターンを設定する必要があります。インデックスパターンに

基づいて、ダッシュボードで特定のログデータを確認したり分析したりできます。

CMMへのアクセス

ログの管理を実施するためには、adminおよびcmm-userロール、またはCMMログ管理機能を使用する権限を与えられているその他の

ロールを持つユーザーとしてOpenStackプラットフォームにアクセスできる必要があります。ロールの追加は任意です

該当ユーザーの認証情報を使ってOpenStackプラットフォームにログインします。これにより、OpenStack Horizonダッシュボードにアクセ

スできます。CMMログ管理機能は、[モニタリング]タブから利用できます。

注意

CMMは、マルチテナントのログ管理をサポートしていません。すなわち、adminロールを持つユーザーは、エージェントの設定で指定し

たプロジェクトに関係なく、すべてのログにアクセスできます。

ログ管理ダッシュボード画面にアクセスするには[モニタリング]タブから行います。[モニタリング] > [概要]と進んでください。[LogManagement]ボタンが、[概要]ページの上部に表示されます。

ダッシュボードにアクセスすると、ログ管理機能すべてを利用することができます。ログデータを確認するには、インデックスパターンを設定


5.1 インデックスパターンの設定

ログ管理ダッシュボードでログデータを表示、分析するためには、少なくとも１つのインデックスパターンを設定しなければなりません。イ

ンデックスパターンは、検索および分析を実行する検索インデックスを特定するために利用します。これらは、ダッシュボードで表示され

るフィールドを自動的に設定するためにも利用されます。

CMMがフィールドのダイナミックマッピングを可能にします。インデックスパターンの設定後、パターンが一致するインデックスは自動的に

スキャンされ、インデックスフィールドのリストが表示されます。これにより、ログ管理ダッシュボードでフィールドが正しく可視化されます。

最初に設定したインデックスパターンが自動的にデフォルトとして設定されます。プロジェクトごとに複数のインデックスパターンを作成す

ることができます。異なるプロジェクトに対してもインデックスパターンを作成することができます。複数のインデックスパターンを作成する場合

は、デフォルトパターンを選択しなければなりません。デフォルトパターンで指定されたインデックスがCMMログ管理ダッシュボードを開いた

際に表示されます。

ログ管理ダッシュボードに初めてアクセスするとき、自動的にインデックスパターンを設定する指示が出ます。インデックスパターンには、下記

の要素を指定します。

・ [Index contains time-based events]　このオプションを選択することを推奨します。これにより、時間ベースのイベントのデータを含む

インデックスのみを検索することで検索性能が改善できます。

・ [Use event times to create index names]　このオプションを選択することを推奨します。これにより、指定した時間範囲内のデータを含

むインデックスのみ検索を可能にすることで検索性能を改善します。

・ [Index pattern interval]　Index pattern intervalに"Daily"を選択します。CMMは日単位でインデックスを作成しています。

・ [Index name or pattern]　動的インデックス名を定義するバターン。パターンで使用する静的テキストは角括弧("["、"］")で囲みます。デ

フォルトで定義されているパターン("[logstash-]*"または"[logstash-]YYYY.MM.DD")を下記のとおり置き換えます。

"logstash-"をダッシュボードで可視化したいログデータが所属するOpenStackプロジェクトのプロジェクトIDに置き換えます。

"*"または"YYYY.MM.DD"をネーミングパターンの"YYYY-MM-DD"に置き換えます。CMMは、このネーミングパターンでインデックスを

作成しています。

- 30 -

例：[557aff4bf007473d84069aca202a1633-]YYYY-MM-DD

・ [Time-field name]　時間フィールド名に"@timestamp"を選択します。"@timestamp"は、YYYY-MM-DDネーミングパターンに一致

します。

5.2 ログ管理ダッシュボードの利用

ログデータを管理するユーザーインターフェースは、Kibanaを使用しています。Kibanaは、基盤となるデータベース技術としてElasticsearchを使用し、データを分析、可視化できるオープンソースです。Kibanaは、ログデータを検索したり参照したり、またインタラクティブに操作

でき、大規模データへの理解をサポートします。さまざまなグラフや表やマップにより、高度なデータ分析と可視化の実施を簡易化できます。ログデータへの変更はリアルタイムに表示されます。

ログ管理ダッシュボードでは、以下の機能を提供します。

・検索クエリを送信し、検索結果をフィルタリングし、フィルタリング結果からデータの確認および分析ができます。検索クエリに一致す

るログエントリの数を確認することができ、フィールド値の統計を取ることができます。時間フィールドがインデックスパターンに設定さ

れている場合、時間に対するログエントリの分布が、ログ管理ダッシュボードの上部にヒストグラムで表示されます。

・検索結果を可視化したグラフや表などを作成することができます。作成したグラフなどは保存したり、個々に利用したり、一つのダッ

シュボード上に組み合わせて表示することができます。データテーブル、折れ線グラフ、円グラフ、垂直棒グラフなど、さまざまなタイプの

可視化をサポートします。

・相互に関連する情報を把握しやすくするために、可視化したグラフなどをダッシュボード上で組み合わせることができます。ダッシュ

ボードは、保存し、あとからリロードすることができます。どのOpenStack運用者もCMM管理者も保存されたダッシュボードにアクセスし

利用することができます。

・ダッシュボードへの直接のリンクを提供、あるいは、Webページに埋め込みを行うことで、ダッシュボードを他のユーザーと共有できます。

ユーザーは、埋め込まれたダッシュボードを利用するためにKibanaにアクセスできることが前提条件となります。

ログ管理ダッシュボードの利用に関する詳細は、Kibana documentationを参照してください。

- 31 -

https://www.elastic.co/guide/en/kibana/4.4/index.html

付録A 構成設定

A.1 CMMメトリックエージェントの構成設定

CMMメトリックエージェントの構成設定は以下のファイルで提供されます。

/etc/monasca/agent/agent.yaml

CMMで利用できるパラメーターの一覧を確認するには、下記の一覧を参照してください。

利用できるパラメーターの説明を表示するために、以下のコマンドを実行します。

/opt/monasca-agent/bin/monasca-setup --help

・ amplifier

・ ca_file

・ check_frequency

・ config_dir

・ detection_args

・ detection_plugins

・ dry_run

・ insecure

・ keystone_url

・ log_dir

・ log_level

・ monasca_url

・ overwrite

・ password

・ project_domain_id

・ project_domain_name

・ project_id

・ project_name

・ remove

・ service

・ skip_enable

・ system_only

・ template_dir

・ user

・ username

・ user_domain_id

・ user_domain_name

・ verbose

- 32 -

注意

dimensionsパラメーターは、CMMでサポートしていません。インストーラはマシン上で動作中のアプリケーションおよびプロセスを自動的

に検知し、それに対応する設定をエージェントの設定ファイルに保存します。追加のディメンションは指定できません。

A.2 CMMログエージェントの構成設定

CMMログエージェントの構成設定は以下のファイルで提供されます。

/etc/monasca/monasca-log-agent/agent.conf

以下に、各設定の詳細を説明します。

monasca_log_api_url

必須。CMMサービスがインストールされているマシンへのアクセスに使用されるURL。

例：http://192.168.10.4:5607/v3.0

keystone_api_url

必須。OpenStack Keystoneサービスがインストールされているサーバへのアクセスに使用されるURL。usernameに指定したユーザーを

認証するために使用するサービスです。

例：http://192.168.10.5:35357/v3

project_name

必須。エージェントがログデータを取得するOpenStackプロジェクトの名前。

例：cmm

username

必須。Keystoneに対してエージェントを認証するために使用するユーザー。

ここで指定するユーザーには、OpenStackにおけるcmm-agentロールと、エージェントがモニタリングするOpenStackプロジェクトが割り当

てられている必要があります。そのプロジェクトは、project_nameで指定されます。

このユーザーは、設定目的専用に使用し、実際のサービスやサーバのモニタリングには使用しないことを推奨します。

例：admin-agent

password

必須。usernameで指定したユーザーのパスワード。

domain_id

必須。usernameで指定したユーザーを割り当てるOpenStack KeystoneドメインのID。

例：default

dimensions

省略可。エージェントが取得したログデータと一緒に収集するメタ情報。この情報は配列として定義されます。

ディメンションにより定義されるメタ情報は各ログエントリに付加されます。これは、CMMログ管理ダッシュボードのフィールドとして表示さ

れます。ログデータを操作しているユーザーに対して、ディメンションはフィルタリングオプションとして使用できます。

例：['app_type:kafka', 'priority:high']

- 33 -

num_of_logs

省略可。ログAPIに送信されるリクエストごとの最大ログ数。

管理するログ数を確認することを推奨します。指定される最大ログ数が低いほど、ログ管理性能が高まります。

利用可能な値：0以上の値

デフォルト：125

max_data_size_kb

省略可。ログAPIに送信されるリクエストごとのキロバイト単位の最大データ量。



elapsed_time_sec

省略可。ログAPIにログを送信する秒単位の間隔。

num_of_logsで指定した最大ログ数、または、max_data_size_kbで指定した最大データ量に達しない場合、ログは指定された間隔

で送信されます。



delay

省略可。elapsed_time_secで指定された時間間隔への到達確認にかかる遅延秒数。



- 34 -

付録B 対応メトリック

以下にCMMでサポートしているメトリックについて説明します。

・サーバおよびネットワークの一般的なモニタリングに対する標準メトリック。

・特定のサーバおよびサービスをモニタリングするための追加メトリック。

OpenStack運用者にとって、OpenStackプラットフォームのサーバおよびサービスのモニタリングには以下のメトリックが適切です。

・すべての標準メトリック。

・次の追加メトリック：apache、host_alive、http_check、libvirt、mysql、ntp、postfix、process、rabbitmq。

CMMメトリックエージェントは、Nagiosプラグインを実行し、プラグインモニタリングAPIに対するメトリックとしてプラグインが返すステ

ータスコードを送信することもできます。CMMでNagiosチェックを使用する方法については、富士通のサポート窓口までお問い合わ

せください。

注意

メトリック用のディメンションを追加することはCMMでサポートしていません。インストーラはマシン上で動作中のアプリケーションおよび

プロセスを自動的に検知し、それに対応する設定をエージェントの設定ファイルに保存します。追加のディメンションは指定できません。

B.1 標準メトリック

CMMは、サーバおよびネットワークをモニタリングするための以下の標準メトリックをサポートします。これらのメトリックは通常、特定の設定を

必要としません。メトリックはメトリックタイプによってグループ分けされます。各メトリックタイプは一連の関連したメトリックを参照します。

cpu.yaml

CPU使用量に関するメトリック。例えば、処理中の入出力要求がない場合にCPUがアイドル状態になる時間の割合や、システム単位ま

たはユーザー単位のCPU使用時間の割合などです。

disk.yaml

ディスクスペースに関するメトリック。例えば、あるデバイスにおける使用ディスク領域の割合や、特定ノード上に存在する全ディスクの使

用領域の合計などです。

load.yaml

各種時間単位(1分間、5分間、15分間など)の平均システム負荷に関するメトリック。

memory.yaml

メモリ使用量に関するメトリック。例えば、全メモリ容量や空きメモリ容量（MB単位）、あるいはスワップメモリの空き容量の割合などです。

network.yaml

ネットワークに関するメトリック。例えば、１秒間に送受信したネットワークバイト数や、送受信トラフィックで発生したネットワークエラーの1秒当

たりの発生件数などです。

B.2 追加メトリック

CMMは、特定のサーバおよびサービスをモニタリングするために、以下に説明している追加メトリックをサポートします。メトリックはメトリ

ックタイプによってグループ分けされます。各メトリックタイプは一連の関連したメトリックを参照します。

- 35 -

CMMメトリックエージェントをインストールするホスト上で動作するサービスに応じて、これらメトリックの一部あるいは全部がエージェント設定

に追加されます。個々のyamlファイルを確認し、必要に応じ設定を変更あるいは訂正するか、含まれるメトリックをモニタリングしない場合

にはyamlファイルを個別にエージェントの設定から削除してください。

以下のメトリックに加えて、Monascaプロジェクトはさらに多くのメトリックを提供しています。これらについて、CMMはインストールもサポ

ートもしません。CMMでサポートしている追加メトリックについて、さらに情報が必要な場合は、Monasca 関連情報を参照してください。

apache.yaml

Apache Webサーバチェックにより、Apache Webサーバからメトリックを収集します。設定ファイルにサーバのURL、および、そのサーバ

にアクセスするユーザー名とパスワードを含める必要があります。

設定例：

init_config:

instances:

- apache_status_url: http://localhost/server-status?auto

apache_user: root

apache_password: password

elastic.yaml

Elasticチェックにより、CMMのログデータベースなどのElasticsearchデータベースのメトリックを収集します。設定ファイルには、HTTPリクエスト用のURLを指定する必要があります。elasticsearch-http-basicなど、Basic認証が使用されている場合、設定ファイル

には認証を必要とするインスタンスごとにユーザー名とパスワードも指定する必要があります。

設定例：

init_config:

instances:

- url: http://localhost:9200

username: username

password: password

host_alive.yaml

ホストの死活チェックは、リモートホストが動作しているか判断するアクティブチェックを行います。このチェックは、ping(ICMP)またはSSHを

使用して行われます。

SSHチェックは、リモートのホストマシンの可用性に関する広範囲に渡るテストを提供します。SSHチェックでは返されたバナーのチェックを行

います。リモートのホストマシンは、ping要求に応答した場合でもSSHバナーを返さないことがあります。そのため、可能であれば、pingチェックの代わりにSSHチェックを行うことを推奨します。

設定例：

init_config:

ssh_port: 22

# ssh_timeout is a floating point number (seconds)

ssh_timeout: 0.5

# ping_timeout is an integer number (seconds)

ping_timeout: 1

instances:

# alive_test can be either "ssh" for an SSH banner test (port 22)

# or "ping" for ICMP ping test instances:

- name: ssh to somehost

host_name: somehost.somedomain.net

alive_test: ssh

- name: ping gateway

- 36 -

https://github.com/openstack/monasca-agent/tree/stable/mitaka/docs/Plugins.md

host_name: gateway.somedomain.net

alive_test: ping

- name: ssh to 192.168.0.221

host_name: 192.168.0.221

alive_test: ssh

http_check.yaml

HTTPエンドポイントチェックは、HTTPエンドポイントが動作しているか停止しているかの確認を行います。エージェントは、URL一覧をもとに

HTTPリクエストを送信し、CMMサービスに成否を報告します。

設定例：

init_config:

instances:

url: http://192.168.0.254/healthcheck

timeout: 1

include_content: true

collect_response_time: true

match_pattern: '.*OK.*OK.*OK.*OK.*OK'

kafka_consumer.yaml

Kafkaコンシューマーチェックにより、CMMのPersisterやNotification Engineなど、Kafkaトピックスを取得しているサービスに関連するメ

トリックを収集します。

Kafkaコンシューマーチェックを使用するためには、Kafkaコンシューマーモジュール（kafka-python）をCMMメトリックエージェントの

virtualenv環境にインストールしておく必要があります。デフォルトのディレクトリにインストールするには、以下のコマンドを実行します。

# source /opt/monasca-agent/bin/activate

# pip install kafka-python

# deactivate

設定例：

Init_config:

instances:

- consumer_groups:

'1_alarm-state-transitions':

'alarm-state-transitions': ['3', '2', '1', '0']

'1_metrics':

'metrics': &id001 ['3', '2', '1', '0']

'test':

'healthcheck': ['1', '0']

'thresh-event':

'events': ['3', '2', '1', '0']

'thresh-metric':

'metrics': *id001

kafka_connect_str: localhost:9092

zk_connect_str: localhost:2181

libvirt.yaml

Libvirtチェックは、ハイパーバイザー上で動作する仮想マシンに対するメトリックを提供します。このチェックは、ハイパーバイザーのオ

ーナーだけでなく、仮想マシンのオーナーにもメトリックを提供します。

設定例：

init_config:

admin_password: pass

admin_tenant_name: services

- 37 -

admin_user: nova

identity_uri: 'http://192.168.10.5:35357/v2.0'

region_name: 'region1'

cache_dir: /dev/shm

nova_refresh: 14400

vm_probation: 300

ping_check: /usr/bin/fping -n -c1 -t250 -q

ping_only: false

instances:

- {}

mysql.yaml

MySQLチェックにより、MySQLデータベースサーバからメトリックを収集します。メトリックはMySQLのサーバステータス変数に関連して

います。

MySQLチェックを使用するためには、MySQLモジュール（pymysql）をCMMメトリックエージェントのvirtualenv環境にインストールしておく

必要があります。デフォルトのディレクトリにインストールするために、以下のコマンドを実行します。


# pip install pymysql

# deactivate

設定例：

init_config:

instances:

defaults_file: /root/.my.cnf

server: localhost

user: root

ntp.yaml

ネットワークタイムプロトコル（NTP）チェックは、NTPサーバとホストマシンとの時間オフセットをモニタリングします。設定ファイルには、ホスト

名、ポート番号、バージョン情報、タイムアウトを指定する必要があります。

設定例：

init_config:

instances:

- host: pool.ntp.org

port: ntp

version: 3

timeout: 5

postfix.yaml

PostfixチェックはPostfixメールサーバをモニタリングします。設定ファイルには、モニタリングするサーバの名前、ディレクトリ、キューを指定

する必要があります。

設定例：

init_config:

instances:

- name: /var/spool/postfix

directory: /var/spool/postfix

queues:

- incoming

- active

- deferred

- 38 -

postgres.yaml

Postgresチェックにより、PostgreSQLデータベースサーバーからメトリックを収集します。

Postgresチェックを使用するためには、RPMパッケージ(postgresql-devel)とPythonパッケージ(psycopg2)が必要です。Pythonパッケージは

CMMメトリックエージェントのvirtualenv環境にインストールしておく必要があります。デフォルトのディレクトリにインストールするために、以下

のコマンドを実行します。

# yum install postgresql-devel


# pip install psycopg2

# deactivate

設定例：

init_config:

instances:

- host: localhost

port: 5432

username: my_username

password: my_password

dbname: db_name

relations:

- my_table

- my_other_table

process.yaml

プロセスチェックは、定義された一連のプロセスが動作中か検証します。対象となるプロセスは、プロセス名かパターンマッチを指定す

ることで識別できます。

設定例：

init_config:

instances:

- name: ssh

search_string: ['ssh', 'sshd']

- name: mysql

search_string: ['mysql']

exact_match: True

rabbitmq.yaml

RabbitMQチェックにより、RabbitMQサーバからノード、エクスチェンジおよびキューに関するメトリックを収集します。設定ファイルには、モ

ニタリングするエクスチェンジおよびキューの名前を指定する必要があります。

RabbitMQチェック用に、RabbitMQ管理プラグインをインストールしなければなりません。このプラグインはRabbitMQディストリビューションに

含まれています。プラグインを有効にするために、以下のコマンドを実行します。

rabbitmq-plugins enable rabbitmq_management

設定例：

init_config:

instances:

- exchanges: [nova, cinder, ceilometer, glance, keystone, neutron, heat]

nodes: [rabbit@devstack]

queues: [conductor]

rabbitmq_api_url: http://localhost:15672/api

- 39 -

rabbitmq_user: guest

rabbitmq_pass: guest

zk.yaml

ZooKeeperチェックにより、ZooKeeperがカバーするノードおよび接続に関するメトリックを収集します。ZooKeeperは、設定情報の保守、ネ

ーミング、分散同期の提供、グループサービスの提供を行う集中サービスです。このチェックでは、ZooKeeperの管理者コマンドであるstat

コマンドの実行結果をパースします。

設定例：

init_config:

instances:

host: localhost

port: 2181

timeout: 3

- 40 -

付録C 用語集

ディメンション

リージョン、アベイラビリティーゾーン、サービス層、リソースIDなどのモニタリング対象のデータを、柔軟かつ簡潔に記述できるキーと値の

ペア。ディメンションは、モニタリング対象メトリックの特徴を表します。

CMMでは、名前と、ディメンションの組合せによって、メトリックを識別します。ディメンションは、モニタリングデータ用のフィルターとして機能

します。

テナントユーザー

OpenStackのクラウドリソースへの限定的なアクセス権があるユーザーです。テナントユーザーはエンドユーザーにサービスを提供したり、

自身の開発に必要となるサービスをホストしたりします。

メトリック

モニタリングするデータの特徴を柔軟かつ簡潔に記述できる自己記述型のデータ構造体です。メトリックの値は、CMMが収集し提示する

実際のモニタリングデータを示します。

CMM管理者

CMMの管理および保守を行う担当者です。

Elasticsearch

拡張性に優れた全文検索および解析エンジンを提供するオープンソースアプリケーション。CMMは、大量のログデータを保存し、検索し、

分析する基盤となる技術としてElasticsearchを使用します。

Grafana

大規模測定データを可視化するオープンソースアプリケーション。CMMは、CMMモニタリングデータを可視化するためにGrafanaを利用

します。

Infrastructure as a Service　(IaaS)

コンピューターインフラ(一般的にプラットフォームの仮想化環境)をサービスとして提供するもの。

Kibana

Elasticsearchを運用するために設計されたオープンソースの分析および可視化プラットフォーム。CMMはCMMログデータを可視化す

るためにKibanaを利用します。

Logstash

パイプライン機能を備えたデータ収集エンジンを提供するオープンソースアプリケーション。CMMは、Logstashを利用して、ログを収集、

処理、および出力します。

Monasca

OpenStackと統合されたオープンソースのMonitoring as a Serviceソリューションです。CMMのコアを構成します。

OpenStack運用者

CMMの基礎となるプラットフォーム技術であるOpenStackの管理および保守を行います。

Platform as a Service (PaaS)

コンピューティングプラットフォームとソリューションスタックをサービスとして提供するもの。

Software as a Service (SaaS)

要求に応じてサービスとしてプロバイダーがお客さまにアプリケーションの使用を許諾するソフトウェア配備モデル。

- 41 -

Documents

OpenStack運用者ガイド - software.fujitsu.comsoftware.fujitsu.com/jp/manual/manualfiles/m160010/j2ul2187/01z000/j2... · 本書について 本書では、OpenStack運用者がどのようにFUJITSU

OpenStack運用者ガイド - software.fujitsu.comsoftware.fujitsu.com/jp/manual/manualfiles/m160010/j2ul2187/01z000/j2... · 本書について本書では、OpenStack運用者がどのようにFUJITSU