Hitachi

JP1 Version 11 JP1/Service Level Management


9.6 jslmmgrconfig(監視対象サービスの設定)

機能

このコマンドには次の機能があります。

このコマンドは,次の条件を満たした状態で実行してください。

クラスタシステムの場合は,実行系サーバで実行してください。待機系サーバで実行するとエラーになります。

JP1/SLM - Manager(Slave)に対してコマンドを実行する場合,-tオプションで指定できるオプションはeditだけです。edit以外のオプションを使用した場合は,エラーになります。

-tオプションにsetを指定してコマンドを実行する場合は,事前に-tオプションにgetを指定して実行し,出力されるCSVファイルを引数に指定してください。この前提条件は,-mオプションでconfigまたはmonitorのどちらを指定する場合でも,それぞれの-mオプションごとに実行してください。-tオプションにgetを指定して実行しない状態で,setを指定して実行した場合はエラーになります。

このコマンドがメッセージログに出力するメッセージには,識別子として「jslmmgrconfig」が設定されます。

メッセージログについては「7.2.4 メッセージログ」を参照してください。

コマンド実行時に出力されるメッセージについては,「11.3 メッセージの一覧」を参照してください。

形式

実行権限

OSのAdministratorsグループに属するユーザーアカウント

格納先フォルダ

JP1/SLM - Managerのインストール先フォルダ\mgr\bin\

引数

-g△サービスグループ名

監視対象サービスのサービスグループの名称を指定します。ただし,「‐」(ハイフン)で始まる名称は指定できません。

-s△サービス名

監視対象サービスの名称を指定します。ただし,「‐」(ハイフン)で始まる名称は指定できません。

-c

サービスの監視構成を異なる監視構成に変更します。指定方法を次に示します。

-o△出力先のCSVファイルパス

取得した情報の出力先のファイルパスを指定します。取得した情報はCSV形式で出力します。ファイルパス名には,絶対ファイルパスが指定できます。

指定されたディレクトリが存在しないとエラーになります。

指定された出力ファイルがすでに存在する場合は,-fオプションの指定に従います。

CSVファイルの出力フォーマット

CSVファイルの出力フォーマットを次に示します。取得した情報によって,出力フォーマットが異なります。

  • JP1/PFM構成情報およびシステム監視項目設定を取得した場合

    JP1/PFM構成情報およびシステム監視項目設定を取得した場合の出力フォーマットを次に示します。

    サービスグループ名,サービス名
    Registor,Business group,Host,Monitored target,Monitor item,Key field 1,Key field 2,Key field 3,Key field 4,Key field 5,Key field 6,Key field 7,Key field 8,Key field 9,Key field 10
    Register値,Business group値,Host値,Monitored target値,Monitor item値,Key field 1値,Key field 2値,Key field 3値,Key field 4値,Key field 5値,Key field 6値,Key field 7値,Key field 8値,Key field 9値,Key field 10値

    出力フォーマットのフォーマット情報を次に示します。

    表9‒3 出力フォーマットのフォーマット情報

    行番号

    分類

    説明

    1行目

    サービス情報

    取得対象サービスの情報

    2行目

    データ部のヘッダ情報

    データ部の項目情報

    3行目以降

    データ部

    データ部に入る実データ

    出力フォーマットの出力情報を次に示します。

    表9‒4 出力フォーマットの出力情報

    分類

    項目

    説明

    サービス情報

    サービスグループ名

    監視構成情報の取得対象サービスグループ名

    サービス名

    監視構成情報の取得対象サービス名

    データ部

    Register値

    次の値が出力されます。

    0:指定したサービスに登録なし

    1:指定したサービスに登録あり

    Business group値

    業務グループ名

    Host値

    ホスト名

    Monitored target値

    監視対象名

    Monitor item値

    監視項目名

    Key field 1値Key field 10値

    キー値

    キー値を設定していない場合は空文字が出力されます。

  • 監視対象サービスの監視設定を取得した場合

    監視対象サービスの監視設定(サービス監視設定またはシステム監視設定)を取得した場合の出力フォーマットを次に示します。

    サービス監視設定

    サービスグループ名,サービス名,service,Period値
    Monitored target,Avg.response-Reg,Threshold,Trend monitor-Reg,Trend monitor,Throughput-Reg,Threshold,Trend monitor-Reg,Trend monitor,Error rate-Reg,Threshold,Days in baseline calculation,Days till start,Error Predict. Settings-Reg(Avg. response),Sensitivity(Avg. response),Correlated items,Error Predict. Settings-Reg(Throughput),Sensitivity(Throughput),Error Predict. Settings-Reg(Error rate),Sensitivity(Error rate)
    Monitored target値,Avg.response-Reg値,Threshold値,Trend monitor-Reg値,Trend monitor値,Throughput-Reg値,Threshold値,Trend monitor-Reg値,Trend monitor値,Error rate-Reg値,Threshold値,Days in baseline calculation値,Days till start値,Error Predict. Settings-Reg(Avg. response),Sensitivity(Avg. response),Correlated items,Error Predict. Settings-Reg(Throughput),Sensitivity(Throughput),Error Predict. Settings-Reg(Error rate),Sensitivity(Error rate)
    

    出力フォーマットのフォーマット情報を次に示します。

    表9‒5 出力フォーマットのフォーマット情報

    行番号

    分類

    説明

    1行目

    サービス情報

    取得対象サービスの情報

    2行目

    データ部のヘッダ情報

    データ部の項目情報

    3行目以降

    データ部

    データ部に入る実データ

    出力フォーマットの出力情報を次に示します。

    表9‒6 出力フォーマットの出力情報

    分類

    項目

    説明

    監視設定情報

    サービスグループ名

    サービス名

    service

    取得したときに参照したサービスのサービス監視設定の情報です。

    外れ値検知の分析期間

    Period値

    設定している外れ値検知の分析期間を次のどちらかで出力します。

    Short range:直近60日間

    Long range:直近5年間

    対象

    Monitored target値

    指定したサービスが持っているサービス監視設定の対象を次のどちらかで出力されます。

    • All△Web△Access

    • Web トランザクション名

      Webトランザクション名は登録順に表示します。

    監視フラグ

    Avg. response-Reg値

    平均応答時間の有無

    Trend monitor-Reg値

    平均応答時間の有無(傾向監視)

    Throughput-Reg値

    スループットの有無

    Trend monitor-Reg値

    スループットの有無(傾向監視)

    Error rate-Reg値

    エラー率の有無

    Error Predict. Settings(Avg. response) 値

    平均応答時間の有無(外れ値検知)

    Error Predict. Settings(Throughput) 値

    スループットの有無(外れ値検知)

    Error Predict. Settings(Error rate) 値

    エラー率の有無

    監視を実施しているかどうかの情報を次の値で出力されます。

    0:監視フラグなし

    1:監視フラグあり

    値入力

    Threshold値

    平均応答時間のしきい値

    Trend monitor値

    平均応答時間(傾向監視)

    Threshold値

    スループットのしきい値

    Trend monitor値

    スループット(傾向監視)

    Threshold値

    エラー率のしきい値

    Days in baseline calculation値

    ベースラインの蓄積日数

    Days till start値

    開始時期

    設定している値が出力されます。

    感度入力

    Sensitivity(Avg. response) 値

    外れ値検知の応答時間の感度

    Sensitivity(Throughput) 値

    外れ値検知のスループットの感度

    Sensitivity(Error rate) 値

    外れ値検知のエラー率の感度

    監視設定の感度の情報を次の値で出力されます。

    l:低

    m:中

    h:高

    大文字・小文字の区別はされません。

    相関項目

    Correlated items値

    応答時間との相関対象に設定している情報を次の値で出力されます。

    NO:なし

    TH:スループット

    システム監視設定

    サービスグループ名,サービス名,system,Period値
    Host Name,Monitored target Name,Monitor item Name,SLO monitor-Reg,Threshold,Times exceeded,measured,Trend monitor-Reg,hours,Error Predict-Reg,Days in baseline calculation,Days till start,Sensitivity,Times exceeded,measured,Select
    Host Name値,Monitored target Name値,Monitor item Name値,SLO monitor-Reg値,Threshold値,Trend monitor値,Times exceeded値,measured値,Trend monitor-Reg値,hours値,Error Predict-Reg値,Days in baseline calculation値,Days till start値,Sensitivity値,Times exceeded値,measured値,Select値
    

    出力フォーマットのフォーマット情報を次に示します。

    表9‒7 出力フォーマットのフォーマット情報

    行番号

    分類

    説明

    1行目

    サービス情報

    取得対象サービスの情報

    2行目

    データ部のヘッダ情報

    データ部の項目情報

    3行目以降

    データ部

    データ部に入る実データ

    出力フォーマットの出力情報を次に示します。

    表9‒8 出力フォーマットの出力情報

    分類

    項目

    説明

    監視設定情報

    サービスグループ名

    サービス名

    system

    取得したときに参照したサービスのシステム監視設定の情報です。

    外れ値検知の分析期間

    Period値

    設定している外れ値検知の分析期間を次のどちらかで出力します。

    Short range:直近60日間

    Long range:直近5年間

    対象

    Host Name値

    監視対象ホスト名

    Monitored target Name値

    監視対象名

    Monitor item Name値

    監視項目名

    指定したサービスが持っているシステム監視設定の対象です。

    監視フラグ

    SLO monitor-Reg値

    しきい値監視の有無

    Trend monitor-Reg値

    傾向監視の有無

    Error Predict-Reg値

    外れ値検知の有無

    監視を実施しているかどうかの情報を次の値で出力されます。

    0:監視フラグなし

    1:監視フラグあり

    値入力

    Threshold値

    しきい値

    Times exceeded値

    しきい値の超過回数

    measured値

    しきい値の測定回数

    hours値

    傾向監視時間

    Days in baseline calculation値

    ベースラインの蓄積日数

    Days till start値

    外れ値検知の開始時期

    Times exceeded値

    外れ値検知の超過回数

    measured値

    外れ値検知の測定回数

    設定している値が出力されます。

    感度入力

    Sensitivity値

    外れ値検知の感度の情報を次の値で出力されます。

    l:低

    m:中

    h:高

    大文字・小文字の区別はされません。

    基準選択

    Select値

    システム監視構成の場合に,ベースラインの作成の基準となる項目を選択するかを次の値で出力されます。

    0:基準選択としない

    1:基準選択とする

出力文字コード

UTF-8で出力されます。

-i△入力元のCSVファイルパス

更新情報の入力元のファイルパスを指定します。ファイルはCSV形式で入力します。ファイルパス名には,絶対ファイルパスが指定できます。

指定されたディレクトリが存在しないとエラーになります。

CSVファイルの入力フォーマット

CSVファイルの入力フォーマットを次に示します。更新する情報によって,入力フォーマットが異なります。

  • JP1/PFM構成情報およびシステム監視項目設定を更新する場合

    JP1/PFM構成情報およびシステム監視項目設定を更新する場合の入力フォーマットを次に示します。

    サービスグループ名,サービス名
    Registor,Host,Business group,Monitored target,Monitor item,Key field 1,Key field 2,Key field 3,Key field 4,Key field 5,Key field 6,Key field 7,Key field 8,Key field 9,Key field 10
    Register値,Business group値,Host値,Monitored target値,Monitor item値,Key field 1値,Key field 2値,Key field 3値,Key field 4値,Key field 5値,Key field 6値,Key field 7値,Key field 8値,Key field 9値,Key field 10値,itemAddName値
    

    入力フォーマットのフォーマット情報を次に示します。

    表9‒9 入力フォーマットのフォーマット情報

    行番号

    分類

    説明

    1行目

    サービス情報

    更新対象サービスの情報

    2行目

    データ部のヘッダ情報

    データ部の項目情報

    3行目以降

    データ部

    データ部に入る実データ

    入力フォーマットの入力情報を次に示します。

    表9‒10 入力フォーマットの入力情報

    分類

    項目

    説明

    サービス情報

    サービスグループ名

    更新対象のサービスグループ名

    サービス名

    更新対象のサービス名

    データ部

    Register値

    Register値を次の値で入力します。

    0:指定したサービスに登録しない

    1:指定したサービスに登録する

    2:指定したサービスから削除する

    Business group値

    業務グループ名

    Host値

    ホスト名

    Monitored target値

    監視対象名

    Monitor item値

    監視項目名

    Key field 1値Key field 10値

    キー値の入力。

    キー値を設定していない場合は空文字を入力します。

    itemAddName値

    登録時に監視対象名の後ろに追加する文字列。Monitored target値とitemAddName値を結合した文字列が監視項目名になります。

    キー値を指定する場合にだけこの項目の指定は有効となり,キー値を含まない監視項目の場合は指定を無視します。

    この項目に指定できる文字サイズは,UTF-8形式で1024バイト以内です。

  • 監視対象サービスの監視設定を更新する場合

    監視対象サービスの監視設定(サービス監視設定またはシステム監視設定)を更新する場合の入力フォーマットを次に示します。

    サービス監視設定

    サービスグループ名,サービス名,service,Period値
    Monitored target,Avg.response-Reg,Threshold,Trend monitor-Reg,Trend monitor,Throughput-Reg,Threshold,Trend monitor-Reg,Trend monitor,Error rate-Reg,Threshold,Days in baseline calculation,Days till start,Error Predict. Settings-Reg(Avg. response),Sensitivity(Avg. response),Correlated items,Error Predict. Settings-Reg(Throughput),Sensitivity(Throughput),Error Predict. Settings-Reg(Error rate),Sensitivity(Error rate)
    Monitored target値,Avg.response-Reg値,Threshold値,Trend monitor-Reg値,Trend monitor値,Throughput-Reg値,Threshold値,Trend monitor-Reg値,Trend monitor値,Error rate-Reg値,Threshold値,Days in baseline calculation値,Days till start値,Error Predict. Settings-Reg(Avg. response)値,Sensitivity(Avg. response)値,Correlated items値,Error Predict. Settings-Reg(Throughput)値,Sensitivity(Throughput)値,Error Predict. Settings-Reg(Error rate)値,Sensitivity(Error rate)値
    

    入力フォーマットの入力情報を次に示します。

    表9‒11 入力フォーマットのフォーマット情報

    行番号

    分類

    説明

    1行目

    サービス情報

    更新対象サービスの情報

    2行目

    データ部のヘッダ情報

    データ部の項目情報

    3行目以降

    データ部

    データ部に入る実データ

    入力フォーマットの入力情報を次に示します。

    表9‒12 入力フォーマットの入力情報

    分類

    項目

    説明

    監視設定情報

    サービスグループ名

    サービス名

    service

    更新時に参照するサービスのサービス監視設定の情報です。

    外れ値検知の分析期間

    Period値

    設定している外れ値検知の分析期間を次のどちらかで入力します。

    Short range:直近60日間

    Long range:直近5年間

    対象

    Monitored target値

    指定するサービスが持っているサービス監視設定の対象を次のどちらかで入力します。

    • All△Web△Access

    • Web トランザクション名

    監視フラグ

    Avg. response-Reg値

    平均応答時間の有無

    Trend monitor-Reg値

    平均応答時間の有無(傾向監視)

    Throughput-Reg値

    スループットの有無

    Trend monitor-Reg値

    スループットの有無(傾向監視)

    Error rate-Reg値

    エラー率の有無

    Error Predict. Settings(Avg. response)値

    平均応答時間の有無(外れ値検知)

    Error Predict. Settings(Throughput)値

    スループットの有無(外れ値検知)

    Error Predict. Settings(Error rate)値

    エラー率の有無

    監視を実施するかどうかの情報を次の値で入力します。

    0:監視フラグなし

    1:監視フラグあり

    2:監視フラグ解除

    値入力

    Threshold値

    平均応答時間のしきい値

    Trend monitor値

    平均応答時間(傾向監視)

    Threshold値

    スループットのしきい値

    Trend monitor値

    スループット(傾向監視)

    Threshold値

    エラー率のしきい値

    Days in baseline calculation値

    ベースラインの蓄積日数

    Days till start値

    開始時期

    更新したい値を入力します。

    上限値を超えた値を設定した場合はエラーになります。

    感度入力

    Sensitivity(Avg. response)値

    外れ値検知の応答時間の感度

    Sensitivity(Throughput)値

    外れ値検知のスループットの感度

    Sensitivity(Error rate)値

    外れ値検知のエラー率の感度

    監視設定の感度の情報を次の値で入力します。

    l:低

    m:中

    h:高

    大文字・小文字の区別はされません。

    相関項目

    Correlated items値

    応答時間との相関対象に設定する情報を次の値で入力します。

    NO:なし

    TH:スループット

    システム監視設定

    サービスグループ名,サービス名,system,Period値
    Host Name,Monitored target Name,Monitor item Name,SLO monitor-Reg,Threshold,Times exceeded,measured,Trend monitor-Reg,hours,Error Predict-Reg,Days in baseline calculation,Days till start,Sensitivity,Times exceeded,measured,Select
    Host Name値,Monitored target Name値,Monitor item Name値,SLO monitor-Reg値,Threshold値,Trend monitor値,Times exceeded値,measured値,Trend monitor-Reg値,hours値,Error Predict-Reg値,Days in baseline calculation値,Days till start値,Sensitivity値,Times exceeded値,measured値,Select値
    

    入力フォーマットの入力情報を次に示します。

    表9‒13 入力フォーマットのフォーマット情報

    行番号

    分類

    説明

    1行目

    サービス情報

    更新対象サービスの情報

    2行目

    データ部のヘッダ情報

    データ部の項目情報

    3行目以降

    データ部

    データ部に入る実データ

    入力フォーマットの入力情報を次に示します。

    表9‒14 入力フォーマットの入力情報

    分類

    項目

    説明

    監視設定情報

    サービスグループ名

    サービス名

    system

    更新時に参照するサービスのシステム監視設定の情報です。

    外れ値検知の分析期間

    Period値

    設定している外れ値検知の分析期間を次のどちらかで入力します。

    Short range:直近60日間

    Long range:直近5年間

    対象

    Host Name値

    監視対象ホスト名

    Monitored target Name値

    監視対象名

    Monitor item Name値

    監視項目名

    指定したサービスが持っているシステム監視設定の対象です。

    監視フラグ

    SLO monitor-Reg値

    しきい値監視の有無

    Trend monitor-Reg値

    傾向監視の有無

    Error Predict-Reg値

    外れ値検知の有無

    監視を実施するかどうかの情報を次の値で入力します。

    0:監視フラグなし

    1:監視フラグあり

    2:監視フラグ解除

    値入力

    Threshold値

    しきい値

    Times exceeded値

    しきい値の超過回数

    measured値

    しきい値の測定回数

    hours値

    傾向監視時間

    Days in baseline calculation値

    ベースラインの蓄積日数

    Days till start値

    外れ値検知の開始時期

    Times exceeded値

    外れ値検知の超過回数

    measured値

    外れ値検知の測定回数

    更新したい値を入力します。

    上限値を超えた値を設定した場合はエラーになります。

    感度入力

    Sensitivity値

    監視設定の感度の情報を次の値で入力します。

    l:低

    m:中

    h:高

    大文字・小文字の区別はされません。

    基準選択

    Select値

    システム監視構成の場合に,ベースラインの作成の基準となる項目を選択するかを次の値で入力します。

    0:基準選択としない

    1:基準選択とする

    ただし,「1」を指定できるのは,1ファイル内で1監視項目だけです。

入力文字コード

UTF-8で入力します。

-type

取得する監視設定を指定します。指定方法を次に示します。

-f

このオプションは,同時に指定するオプションが-t△getか-t△setかによって,機能が異なります。

-r

登録済みサービスの構成情報には存在しているが,JP1/PFMの構成情報に存在していない監視項目がある場合,登録済みサービスから監視項目を削除します。

このオプションを省略した場合に上記差分があったときは,エラーになります。

-p

監視対象サービスを登録するJP1/SLM - Managerを指定します。指定方法を次に示します。

登録先JP1/SLM - Managerのホスト名,およびIPアドレスの指定形式は,「5.6.2 編集できる定義」の「(1) JP1/SLMで編集できる定義の一覧」に記載されている「managerHost」の指定範囲を参照してください。

-tオプションおよび-mオプションで指定できるオプション一覧を次に示します。

表9‒15 -tオプションおよび-mオプションで指定できるオプション一覧

-tオプションおよび-mオプション

指定できるオプション

-g

-s

-c

-f

-o

-r

-i

-type

-p

-t△edit

×

×

×

×

×

×

-t△get△-m△config

×

×

×

×

-t△get△-m△monitor

×

×

×

×

-t△set△-m△config

×

×

×

×

×

×

×

-t△set△-m△monitor

×

×

×

×

×

×

×

×

-t△add

×

×

×

×

×

(凡例)

◎:必ず指定します。

○:指定は任意です。

×:指定できません。

注意事項

戻り値

戻り値

説明

0

監視対象サービスの設定が正常に終了しました。

1

監視対象サービスの設定に失敗しました。

130

キーボードの「Ctrl」キー+「C」キーで処理が中断されました。

使用例