IBM MQ の権限の設定
Instana エージェントが特権のないユーザーによって実行されている場合、 IBM MQ センサーが監視データを照会および収集するために必要なすべてのアクセス権限を付与する必要があります。
Instana エージェントをインストールするユーザー( 特権ユーザーか非特権ユーザーか )によって、 Instana のUIで監視データにアクセスして表示できる機能が異なります。
特権ユーザー: Instana エージェントが特権ユーザーによってインストールされた場合、必要なすべての権限が与えられます。 したがって、 Instana のUIですべての監視データを確認できます。
特権のないユーザー: Instana エージェントを、キューマネージャーへの接続に権限のないユーザーを使用してインストールする場合、そのユーザーがすべての監視データを照会できるように、適切なObject Authority Manager(OAM)権限を付与する必要があります。
IBM MQ のOAM権限の付与
権限のないユーザーに IBM MQ のOAM権限を付与するには、` setmqaut control`コマンドまたは MQSC `commands`コマンドを使用します。 コマンド setmqaut は $MQ_INSTALLED_DIR/bin ディレクトリにあります。
setmqaut コマンドを実行するユーザー MQSC は、特権ユーザーである必要があります。監視対象のキューマネージャーにアクセスするための適切な権限をユーザーに付与するには、次のいずれかのコマンドを実行してください:
setmqautコマンド:setmqaut -m QMGR -t qmgr -p UserID +connect +dsp +inqMQSC コマンド:
SET AUTHREC PRINCIPAL('UserID') OBJTYPE(QMGR) AUTHADD(CONNECT,DSP,INQ)
ここで:
QMGR: キューマネージャーの名前UserID: ユーザーのユーザーID。
この
-pオプションには、完全修飾ユーザー名を指定する必要があります。 例えば、 -p user@domain または -p user@host.注: ユーザーグループ名を指定するには、`setmqautcommand` コマンド内の `-poption` を `-goption` に置き換えてください。Instana のUIでデータを表示するには、`ne`で指定されたユーザーが
UserIDさまざまなオブジェクトへのアクセス権を持っている必要があります。 権限を付与するには、以下のコマンドのいずれかを実行してください:setmqautコマンド:setmqaut -m QMGR -t queue -n SYSTEM.ADMIN.COMMAND.QUEUE -p UserID +dsp +inq +put +chg setmqaut -m QMGR -t queue -n SYSTEM.DEFAULT.MODEL.QUEUE -p UserID +dsp +get setmqaut -m QMGR -t queue -n SYSTEM.ADMIN.STATISTICS.QUEUE -p UserID +dsp +inq +get +chg setmqaut -m QMGR -t queue -n SYSTEM.ADMIN.QMGR.EVENT -p UserID +dsp +inq +get +chg setmqaut -m QMGR -t queue -n SYSTEM.ADMIN.PERFM.EVENT -p UserID +dsp +inq +get +chg setmqaut -m QMGR -t queue -n SYSTEM.ADMIN.CHANNEL.EVENT -p UserID +dsp +inq +get +chg setmqaut -m QMGR -t queue -n SYSTEM.ADMIN.LOGGER.EVENT -p UserID +dsp +inq +get +chg setmqaut -m QMGR -t queue -n SYSTEM.ADMIN.CONFIG.EVENT -p UserID +dsp +inq +get +chg setmqaut -m QMGR -t queue -n SYSTEM.ADMIN.COMMAND.EVENT -p UserID +dsp +inq +get +chg setmqaut -m QMGR -t queue -n "**" -p UserID +dsp +inq +chg setmqaut -m QMGR -t channel -n "**" -p UserID +dsp setmqaut -m QMGR -t clntconn -n "**" -p UserID +dsp setmqaut -m QMGR -t listener -n "**" -p UserID +dsp setmqaut -m QMGR -t topic -n "**" -p UserID +dspMQSC コマンド:
SET AUTHREC PROFILE('SYSTEM.ADMIN.COMMAND.QUEUE') OBJTYPE(QUEUE) PRINCIPAL('UserID') AUTHADD(DSP,INQ,PUT,CHG) SET AUTHREC PROFILE('SYSTEM.DEFAULT.MODEL.QUEUE') OBJTYPE(QUEUE) PRINCIPAL('UserID') AUTHADD(DSP,GET) SET AUTHREC PROFILE('SYSTEM.ADMIN.STATISTICS.QUEUE') OBJTYPE(QUEUE) PRINCIPAL('UserID') AUTHADD(DSP,INQ,GET,CHG) SET AUTHREC PROFILE('SYSTEM.ADMIN.QMGR.EVENT') OBJTYPE(QUEUE) PRINCIPAL('UserID') AUTHADD(DSP,INQ,GET,CHG) SET AUTHREC PROFILE('SYSTEM.ADMIN.PERFM.EVENT') OBJTYPE(QUEUE) PRINCIPAL('UserID') AUTHADD(DSP,INQ,GET,CHG) SET AUTHREC PROFILE('SYSTEM.ADMIN.CHANNEL.EVENT') OBJTYPE(QUEUE) PRINCIPAL('UserID') AUTHADD(DSP,INQ,GET,CHG) SET AUTHREC PROFILE('SYSTEM.ADMIN.LOGGER.EVENT') OBJTYPE(QUEUE) PRINCIPAL('UserID') AUTHADD(DSP,INQ,GET,CHG) SET AUTHREC PROFILE('SYSTEM.ADMIN.CONFIG.EVENT') OBJTYPE(QUEUE) PRINCIPAL('UserID') AUTHADD(DSP,INQ,GET,CHG) SET AUTHREC PROFILE('SYSTEM.ADMIN.COMMAND.EVENT') OBJTYPE(QUEUE) PRINCIPAL('UserID') AUTHADD(DSP,INQ,GET,CHG) SET AUTHREC PROFILE('**') OBJTYPE(QUEUE) PRINCIPAL('UserID') AUTHADD(DSP,INQ,CHG) SET AUTHREC PROFILE('**') OBJTYPE(CHANNEL) PRINCIPAL('UserID') AUTHADD(DSP) SET AUTHREC PROFILE('**') OBJTYPE(CLNTCONN) PRINCIPAL('UserID') AUTHADD(DSP) SET AUTHREC PROFILE('**') OBJTYPE(LISTENER) PRINCIPAL('UserID') AUTHADD(DSP) SET AUTHREC PROFILE('**') OBJTYPE(TOPIC) PRINCIPAL('UserID') AUTHADD(DSP)
注: キューのリセット統計データを取得するには、キュー・オブジェクトに対する変更権限(setmqaut および+chgMQSCCHGでの権限)が必要です。 必要に応じて変更権限を付与しないようにすることもできますが、その場合、キューのダッシュボードにはキューのリセット統計データが表示されなくなります。すべてのコマンドが正常に動作するように、キューマネージャーを再起動するか、セキュリティを更新してください:
echo "REFRESH SECURITY" | runmqsc QMGR
これらの権限には、 IBM MQ センサーが監視データを照会および収集するために必要なすべてのアクセス権が含まれています。
追加の権限
通常、ほとんどの監視データのニーズには、読み取り専用アクセスで十分です。 ただし、以下の指標の一部については、追加の権限が必要です。 必要な監視指標に基づき、これらの要件を満たすよう権限を調整する必要があります。
キューのリセット統計データ:
キューのリセット統計データを取得するには、キュー
changeオブジェクトに権限 (+chg) が必要です。キュー
SYSTEM.ADMIN.STATISTICS.QUEUEからの統計データ:この
SYSTEM.ADMIN.STATISTICS.QUEUEキューの統計データにアクセスするには、権限get(+get)が必要です。これは、統計データがこのキューから収集されるためです。IBM MQ イベント:
キューマネージャーイベント、パフォーマンスイベント、チャネルイベントなどの IBM MQ イベントを取得するには、システムキューである
SYSTEM.ADMIN.CHANNEL.EVENTSYSTEM.ADMIN.PERFM.EVENTSYSTEM.ADMIN.QMGR.EVENT、およびに対して権限をget付与してください+get。IBM MQ PCFインターフェースからの監視データ:
IBM MQ センサーは、データを取得するためにPCFインターフェースを呼び出します。 IBM MQ の管理メカニズムは、キュー
SYSTEM.ADMIN.COMMAND.QUEUEに対してputauthority(+put)を使用し、commandPCFを実行します。 キューテンプレートに基づいて一時的なキューを作成し、そのPCFコマンドを保存するには、キューマネージャーには、キューSYSTEM.DEFAULT.MODEL.QUEUEからキューテンプレートを取得する権限getが必要です。