管理対象システム名

管理対象システム名 (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 または AIXLinux システムまたは AIX システムでは、28 文字からホスト名を引いた長さ。
      • Windows
Windows システムでの構成用にサイレント応答ファイルを使用する場合、28 文字からホスト名を引いた長さ。例えば、Server-Name の長さは 11 文字です。したがって、Server-Name ホスト上のエージェント・インスタンスは、長さが 17 文字以下でなければなりません。
      • Windows
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 の形式」列のイタリックのストリングのみを変更できます。

表 1. 特殊な MSN の形式
エージェント MSN の形式 MSN の例
Amazon EC2 エージェント B5:ec2subnodename:INS B5:sales:INS
Amazon ELB エージェント
  • AL:instancenameA:APP
  • AL:instancenameC:CLA
  • AL:instancenameN:NET
  • AL:elb-inst3A:APP
  • AL:elb-inst3C:CLA
  • AL:elb-inst3N:NET
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:dbconnection-instancename-hostname:ASM
  • RZ:dbconnection-instancename-hostname:DG
  • RZ:dbconnection-instancename-hostname:RDB
RZ:11g-oracledbdemo-GVT-1BL:RDB
Ruby エージェント KM:hostname_appname:RAP KM:nc9098036112_Blog:RAP
SAP エージェント
  • SAP インスタンス: instancename-hostname_sid_instancenumber:Ins
  • SAP プロセス統合: instancename-hostname:PI
  • SAP Solution Manager: instancename-hostname:Slm
  • SAP システム: instancename-hostname:Sys
  • PS5-IBMSAP3V1_PS5_11:Ins
  • PS5-IBMSAP3V1:PI
  • PS8-IBMSAP3V3:Slm
  • PS5-IBMSAP3V1:Sys
SAP HANA データベース・エージェント
  • SAP Hana データベース: S7:dbname-systemsid:HDB
  • SAP Hana システム: instancename:hostname:S7
  • S7:HNA-HNA:HDB
  • HNA:PS8760:S7
SAP NetWeaver Java™ Stack エージェント
  • SAP NW Java AS クラスター: instancename:hostname:SV
  • SAP NW Java AS インスタンス: SV:systemsid-jvmid:NWJ
  • J01:VPT02F17:SV
  • SV:J01-83309750:NWJ
UNIX OS エージェント hostname:KUX worklight17:KUX
WebLogic エージェント WB:instancename:WLS WB:Server1:WLS
WebSphere® Applications エージェント
  • WebSphere Application Server: serveralias:hostname:KYNS
  • WebSphere Portal Server: serveralias:hostname:KYNR
  • WebSphere Process Server: serveralias:hostname:KYNP
simpletrade:worklight17:KYNS
WebSphere MQ エージェント monitoredqmgrname:agentname:MQ TRADEQM:PoC:MQ
Windows OS エージェント Primary:hostname:NT Primary:TRADEIIS1:NT