管理対象システム名
管理対象システム名 (MSN) は、ご使用の環境内で各 Cloud APM エージェントを一意的に識別するために使用されます。また、ナビゲーターの「グループ」セクションから各管理対象システムのグループを選択するときに、Application Performance ダッシュボードに表示されるインスタンス名でもあります。 ご使用の環境内での競合を避けるために、エージェントに固有の MSN を割り当ててください。
エージェントの MSN の形式は、エージェント・タイプによって異なります。以下のいずれかのカテゴリーに分類されます。
単一インスタンス・エージェントの一般的な MSN の形式
ほとんどの単一インスタンス・エージェントの場合、MSN の共通形式は次の形式になります。
hostname:pcここで、- hostname は、エージェントのインストール先コンピューターの名前です。この部分は、必要に応じて変更できます。
- pc は、大文字の 2 文字のエージェント・コードであり、変更することはできません。エージェント・コードについて詳しくは、エージェント・コマンドの使用を参照してください。
:は、分離文字であり、変更することはできません。
例: linuxhost01:LZ は、Linux OS エージェントの MSN です。
この MSN の形式に従わない一部の単一インスタンス・エージェントは、表 1 にリストされています。
MSN は 32 文字に制限されています。この MSN カテゴリーでは、エージェント・コードと分離文字を変更できないため、ホスト名に 29 文字を使用できます。
重要: MSN の長さが 32 文字を超える場合は、MSN の一部が切り捨てられ、Cloud APM コンソールに正しく表示されません。例えば、ご使用のホスト名が
VeryLongSalesDivisionServerName03 の場合、管理対象システム名は VeryLongSalesDivisionServerName03:PC になります。ただし、これは VeryLongSalesDivisionServerName0 に切り捨てられます。複数インスタンス・エージェントの一般的な MSN の形式
ほとんどの複数インスタンス・エージェントの場合、MSN の共通形式は次の形式になります。
instancename:hostname:pcここで、- instancename は、エージェントの構成中に指定するエージェント・インスタンス名です。この変数を使用して、各エージェント・ホスト・コンピューター上の各エージェント・タイプの各インスタンスに対して固有の MSN が割り当てられるようにします。要確認:
- エージェント・インスタンス名の作成には、英字 (a-z、A-Z)、アラビア数字 (0-9)、およびハイフンマイナス文字 (-) を使用できます。
- エージェント・インスタンス名に下線文字 (_) は使用できません。
- 指定するインスタンス名は、以下のように制限されます。
Linux システムまたは AIX システムでは、28 文字からホスト名を引いた長さ。
Windows システムでの構成用にサイレント応答ファイルを使用する場合、28 文字からホスト名を引いた長さ。例えば、Server-Nameの長さは 11 文字です。したがって、Server-Nameホスト上のエージェント・インスタンスは、長さが 17 文字以下でなければなりません。
Windows システムで Cloud APM コンソール構成を使用する場合は、ホスト名が 8 文字を超えた分を 20 文字から引いた長さ。例えば、TestServerは長さ 10 文字であり、8 文字を 2 文字上回っています。 したがって、TestServerホスト上のエージェント・インスタンスは、長さが 18 文字以下でなければなりません。
- hostname は、エージェントのインストール先コンピューターの名前です。必要に応じて、MSN のホスト名コンポーネントを変更できます。
- pc は、大文字の 2 文字のエージェント・コードであり、変更することはできません。エージェント・コードについて詳しくは、エージェント・コマンドの使用を参照してください。
:は、分離文字であり、変更することはできません。
例: jboss1:win2016:JE は、JBoss エージェントの MSN です。
この MSN の形式に従わない一部のマルチインスタンス・エージェントは、表 1 にリストされています。
MSN は 32 文字に制限されています。この MSN カテゴリーでは、エージェント・コードと分離文字を変更できないため、インスタンス名とホスト名の間に 28 文字を使用できます。
重要: MSN の長さが 32 文字を超える場合は、MSN の一部が切り捨てられ、Cloud APM コンソールに正しく表示されません。例えば、インスタンス名として
VeryLongInstanceName を指定し、ご使用のサーバー名が Production09 である場合、管理対象システム名は VeryLongInstanceName:Production09:PC になります。ただし、これは VeryLongInstanceName:Production0 に切り捨てられます。特殊な MSN の形式
特殊な MSN の形式は、MSN が上記の 2 つの一般的な MSN の形式に従わないエージェントに適用されます。これらのエージェントは、表 1にリストされます。
特殊な MSN は 32 文字に制限されています。表 1 で、「MSN の形式」列のイタリックのストリングのみを変更できます。
| エージェント | MSN の形式 | MSN の例 |
|---|---|---|
| Amazon EC2 エージェント | B5:ec2subnodename:INS |
B5:sales:INS |
| Amazon ELB エージェント |
|
|
| Azure Compute エージェント | AK:azure_compute_subnode_name:AVM |
AK:azc-inst3:AVM |
| Citrix VDI エージェント | VD:citrixsitename:XDS |
VD:xds1:XDS |
| DataPower® エージェント | BN:datapowersystemname:DPS |
BN:datapower23:DPS |
| HTTP Server エージェント | HU:hostname_alias:HUS |
HU:docker-ihs_httpd:HUS |
| IBM® Integration Bus エージェント | monitoredbrokername:agentID:KQIB |
TRADEBRK:AGT1:KQIB |
| MQ Appliance エージェント | MK:hostname_sectionname:ARM |
MK:bvtmin_linux150:ARM |
| Node.js エージェント | NJ:hostname_port:NJA |
NJ:KVM-014179_3000:NJA |
| Oracle Database エージェント |
|
RZ:11g-oracledbdemo-GVT-1BL:RDB |
| Ruby エージェント | KM:hostname_appname:RAP |
KM:nc9098036112_Blog:RAP |
| SAP エージェント |
|
|
| SAP HANA データベース・エージェント |
|
|
| SAP NetWeaver Java™ Stack エージェント |
|
|
| UNIX OS エージェント | hostname:KUX |
worklight17:KUX |
| WebLogic エージェント | WB:instancename:WLS |
WB:Server1:WLS |
| WebSphere® Applications エージェント |
|
simpletrade:worklight17:KYNS |
| WebSphere MQ エージェント | monitoredqmgrname:agentname:MQ |
TRADEQM:PoC:MQ |
| Windows OS エージェント | Primary:hostname:NT |
Primary:TRADEIIS1:NT |