ホーム>プログラミング関連>JAVAソースコード
ダウンロード

MySQL パフォーマンス アナライザー

MySQL Performance Analyzer は、MySQL パフォーマンスの監視と分析のためのオープンソース プロジェクトです。このリポジトリには 2 つのサブ プロジェクトが含まれています。

  • Java Web アプリケーション プロジェクト myperf
  • Java Web サーバー桟橋ラッパー

建てる

MySQL Performance Analyzer は Java Maven プロジェクトです。ビルドするには JDK および Maven 3.0 以降が必要です。

JDK 8 は pom.xml で指定されていますが、このプロジェクトは Java 8 固有の機能を使用しないため、ユーザーは 2 つのサブプロジェクトの pom.xml ファイルを変更して、異なる JDK バージョンを使用できます。たとえば、ビルド ホストに JDK 7 のみがある場合は、ファイル myperf/pom.xml を変更し、次の行を変更します。 

  	<source>1.8</source>
	<target>1.8</target>

に

	<source>1.7</source>
	<target>1.7</target>

ビルドにより、ディレクトリ perfJettyServer/target に myperfserver-server.zip という名前の zip ファイルが作成されます。これをビルドするには、トップレベルで次を実行します

  mvn clean package

インストールと使用手順

  1. 要件: Java JDK 8、またはビルド時に変更された場合は pom.xml で指定されたもの。

  2. myperfserver-server.zip を目的のインストール ディレクトリに解凍します。 Windows ホストにインストールする場合は、2 つのシェル スクリプトを確認し、Windows に相当するスクリプトを作成してください。

    今後の更新については、ほとんどの場合、myperf/target/myperf.war をインストール ディレクトリの下の webapps ディレクトリにコピーして、再起動するだけで済みます。

  3. より正式なインストールの場合は、メトリクスを保存するバック ストアとして MySQL データベース サーバーを使用することをお勧めします。それ以外の場合は、組み込みの derby db を使用します。

    • たとえば、MySQL データベース サーバーを使用して、メトリックという名前のデータベースを作成します。
    • 上記のスキーマに対するすべての権限を持つ MySQL ユーザー (たとえば、「metrics」@「my_host」 -> ここで、my_host は MySQL パフォーマンス アナライザーを実行するマシンです) を作成します。
    • 上記の情報は、メトリック収集を設定するためにアナライザーに初めてログインするときに必要になります。

  4. スクリプト start_myperf.sh を確認して、コマンド ライン設定を変更する必要があるかどうかを確認してください。通常、変更する必要があるのはポート番号だけです

    • -f: config、構成ファイルのパス。使用すると、構成ファイル内の値が最初にロードされますが、コマンドライン引数によって上書きされる可能性があります。
    • -j: 桟橋ホーム、そのままにしておきます
    • -p: 使用する http ポート、デフォルトでは 9092
    • -w: war (Web アーカイブ) ファイル。myperf.war である必要があります。
    • -k: 作業ディレクトリ。指定しない場合、./work が使用されます。
    • -c: URL コンテキスト、デフォルトは /myperf、そのままにしておきます。

    以下は、Java プロパティ ファイル形式 (名前=値のペア) を使用する構成ファイルで許可されるリストです。

    • 桟橋ホーム
    • useHttps: 値はい/y/いいえ/n/true/false
    • ポート
    • ウェブコンテキストルート
    • 作業ディレクトリ
    • ログパス
    • 戦争ファイル
    • 証明書キーストアパス
    • 証明書キーストアのパスワード

    https をサポートするには、SSL 証明書 (自己署名またはサードパーティ署名) を提供し、Java keytool を使用して Java キーストアに保存する必要があります (https://wiki.eclipse.org/Jetty/Howto/Configure_SSL を参照)。 SSL と非 SSL を切り替えるときにログインの問題が発生した場合は、ブラウザーが提供する Cookie ツールを使用して、このアプリケーションをホストするサーバーから発信されたブラウザー Cookie を削除する必要があります。

    複数の JDK パッケージがインストールされている場合など、必要に応じて、start_myperf.sh 内の Java コマンド パスを変更します。

  5. 起動する： 

       ./start_myperf.sh

    nohup.out と logs ディレクトリにエラー ログがないか確認してください。

  6. シャットダウン: 

       ./stop_myperf.sh

  7. 初回ログインとセットアップ

起動後、ブラウザで http://your_host:9092/myperf (または変更したポート番号) を指定します。または https://your_host:9092/myperf (https が正しく構成されている場合)。

初期ログイン ユーザーと資格情報は myperf/change です。

ログイン後、セットアップ ページに移動します。

  • 通知用のメールアドレスを追加できます。メールはOSの「mailx」コマンドを使用します。

  • 前の手順で作成したものを使用して、メトリクス ストレージ データベースを構成します。

    メトリクスのスキャン間隔は 1 分または 5 分で十分です。

  • 組み込みの derbydb を使用する場合は、短い保存日数を選択します。

  • 設定が完了したら、スキャナを起動する必要があります (ページ上部の「スキャナの起動」ボタン)。

    設定を変更するたびに、スキャナを再起動する必要があります。

  • スキャナーが期待どおりに動作しない場合は、アナライザーを再起動します。 

       ./stop_myperf.sh

    それから

       ./start_myperf.sh

  • SNMP がデフォルト以外のコミュニティ、またはバージョン v2c を使用していない場合は、[SNMP 設定] タブを使用して SNMP を設定します。現在、Linux ベースの SNMP のみがサポートされています。 MySQL サーバーが Linux 上で実行されていない場合は、[アラート設定] タブを使用して SNMP メトリック ポーリングを無効にします。

  1. 監視するデータベース サーバーごとに、次の権限を持つ MySQL ユーザーを作成する必要があります。

    • プロセス
    • レプリケーションクライアント
    • データベースを表示
    • ビューを表示
    • すべてを選択 (データ ディクショナリを確認するか、Explain Plan を実行するために使用する場合)

  2. アナライザーは Linux SNMP を利用して OS レベルのデータを収集します。 snmpd サービスのステータスを確認します。

  3. HipChat の統合: 仕事関連のコラボレーションに HipChat を使用する場合、MySQL Perf Analyzer からアラートを受信するための HipChat ルームを作成できます。 HipChat 統合のセットアップ方法については、https://developer.atlassian.com/hipchat/tutorials/building-a-simple-add-on-using-a-wizard を確認してください。 HipChat 通知 URL と認証トークンを取得したら、設定ページを使用してルームに通知を送信するように MySQL Perf Analyzer を構成できます。

既知の制限事項

  1. SNMP は Linux 仕様に基づいています。
  2. メール通知にはLinuxの「mailx」コマンドを使用します。

ライセンス

このコードは、Apache ライセンスに基づいてライセンスされています。条件については、LICENSE ファイルを参照してください。

拡大する
追加情報
関連アプリ
おすすめ
関連情報 すべて