제공된 MBean 목록
Liberty는 서버를 조작하고 모니터링하는 데 사용할 수 있는 MBeans 및 대응되는 관리 인터페이스의 목록을 제공합니다. MBean 프록시를 사용하는 경우 ${wlp.install.dir}/dev/api/ibm의 .jar 내에서 컴파일해야 할 클래스를 찾으십시오.
- 이름은 MBean 또는 MXBean을 고유하게 식별하는 javax.management.ObjectName입니다. MBean 또는 MXBean 인스턴스가 여러 개 있는 경우 ObjectName 값에는 이 주제의 주석 항목에 설명된 와일드카드(*)가 포함될 수 있습니다.
- 관리 인터페이스 항목은 MBean 속성 및 조작 액세스 예에 설명된 대로 MBean 또는 MXBean의 프록시 오브젝트를 구성하는 데 사용될 수 있는 Java 인터페이스의 이름을 지정합니다. 관리 인터페이스에 대한 자세한 정보는 Liberty의 Java API 문서를 참조하십시오. 각 Liberty API에 대한 Java API 문서는 온라인 IBM® Knowledge Center의 프로그래밍 인터페이스(Javadoc) 절에 자세히 설명되어 있으며, ${wlp.install.dir}/dev 디렉토리의 javadoc 서브디렉토리 중 하나에서 별도 .zip 파일로서도 사용 가능합니다.
WebSphere:feature=channelfw,type=endpoint,name=*
- 관리 인터페이스: com.ibm.websphere.endpoint.EndPointInfoMBean
- 주석: 시스템의 각 애플리케이션에 대해 인스턴스를 하나씩 사용할 수 있습니다. 여기서 *는 고유 애플리케이션 이름입니다.
WebSphere:feature=dynamicRouting,type=DynamicRouting,name=DynamicRouting
- 관리 인터페이스: com.ibm.websphere.dynamic.routing.DynamicRoutingMBean
- 주석: 이 MBean은 동적 라우팅 기능이 사용으로 설정될 때 사용 가능합니다. 동적 라우팅을 위한 웹 서버 플러그인 구성을 생성하기 위한 조작을
제공합니다.
의 내용을 참조하십시오.
WebSphere:feature=kernel,name=ServerInfo
- 관리 인터페이스: com.ibm.websphere.kernel.server.ServerInfoMBean
- 주석: ServerInfoMbean 인터페이스는 실행 중인 서버에 대한 정보를
검색하는 데 사용됩니다. 클래스 및 API 문서에 대해 다음 디렉토리를 검색하십시오.
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.kernel.service_version-javadoc.zip
노출된 조작에는 제품 설치 및 사용자 디렉토리 위치, 기본 호스트 이름, 서버 이름, 제품 버전, Java 스펙 버전, Java Runtime 버전을 검색하기 위한 메소드가 포함됩니다.
![[18.0.0.1 and later]](../ng_v18001plus.gif)
WebSphere:feature=kernel,name=ServerEndpointControl
- 관리 인터페이스: com.ibm.websphere.kernel.server.ServerEndpointControlMBean
- 주석: ServerEndpointControlMBean 인터페이스는 서버 엔드포인트의 상태를 일시정지하고 재개하며 가져오는 데 사용됩니다. 이 MBean은 커널에서 사용할 수 있으므로 특수
기능을 사용으로 설정하지 않아도 됩니다. 다음 위치에서 MBean 클래스 및
API 문서를 찾을 수 있습니다.
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.kernel.service_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.kernel.service_version-javadoc.zip
일시정지할 수 있는 엔드포인트의 목록의 경우 명령행에서 Liberty 서버 일시정지 및 재개의 내용을 참조하십시오.
WebSphere:feature=restConnector,type=FileService,name=FileService
- 관리 인터페이스: com.ibm.websphere.filetransfer.FileServiceMXBean
- 주석: 이 MXBean을 사용하면
Liberty가 상주하는 호스트에서 다양한 파일 관련 조작을 수행할 수 있습니다. 다음 위치에서 해당되는 클래스와 API 문서를 찾을 수 있습니다.
liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.restConnector_version.jar liberty_home/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.restConnector_version-javadoc.zip
노출된 조작에는 특정 파일 또는 디렉토리에 대한 특정 메타데이터(마지막 수정 날짜, 크기 등)를 조회하고 특정 디렉토리에 대한 모든 하위 파일(및 해당되는 메타데이터)를 조회할 수 있는 기능이 포함됩니다. 아카이브 작성 및 확장에 대한 지원도 제공되며, 이는 Liberty 로그 파일을 압축하거나 배치 전에 애플리케이션을 추출하는 데 유용할 수 있습니다.
이 MXBean에는 두 가지의 속성인 읽기 목록 및 쓰기 목록이 포함됩니다. 이는 Liberty에서 제공하는 FileService 또는 FileTransfer 기능을 사용할 때 사용자가 읽거나 쓸 수 있는 위치의 목록을 나타냅니다. MXBean을 통해, 이 속성을 읽기 전용일 수 있지만 server.xml 파일에서 다음 요소를 통해 구성하거나 사용자 정의할 수 있습니다.
readDir 요소를 지정하지 않은 경우 기본값은 ${wlp.install.dir}, ${wlp.user.dir} 및 ${server.output.dir}의 조합입니다. writeDir 요소를 지정하지 않은 경우 기본값은 빈 세트입니다.<remoteFileAccess> <readDir>${server.output.dir}/logs</readDir> <readDir>${server.output.dir}/apps</readDir> <writeDir>${server.output.dir}/dropins</writeDir> </remoteFileAccess>
이 MXBean이 로드되고 해당 구성 요소를 적용하도록 하려면 restConnector-1.0 기능이 server.xml 파일에 포함되어야 합니다.
Liberty 정의 변수의 사용은 파일 경로를 표시하는 문자열을 사용하는 모든 서버 측 매개변수에서 허용됩니다. 이와 같은 변수는 liberty_home/README.TXT 파일에서 정의됩니다.
WebSphere:feature=restConnector,type=FileTransfer,name=FileTransfer
- 관리 인터페이스: com.ibm.websphere.filetransfer.FileTransferMBean
- 주석: 이 MBean을 사용하면
Liberty가 상주하는 호스트에서 다양한 파일 전송 조작을 수행할 수 있습니다. 다음 위치에서 해당되는 클래스와 API 문서를 찾을 수 있습니다.
liberty_home/dev/api/ibm/com.ibm.websphere.appserver.api.restConnector_version.jar liberty_home/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.restConnector_version-javadoc.zip
이 MBean은 대응되는 Liberty 프로세스가 실행 중인 동일한 JVM의 PlatformMBeanServer에 등록되어 있지만, 이는 IBM JMX REST Connector를 사용해서만 액세스될 수 있습니다. 연결은 로컬 또는 원격이 될 수 있지만 REST 커넥터를 사용해야 합니다.
노출된 조작에는 파일을 다운로드, 업로드 및 삭제하기 위한 기능이 포함됩니다. 서버에서의 각 읽기 및 쓰기 요청은 FileServiceMXBean를 통해 액세스하는 구성 가능한 읽기 및 쓰기 목록에 바인드됩니다. 또한 FileTransferMBean은 JConsole이 IBM JMX REST Connector를 통해 연결된 경우 내장 Java JConsole에서 완전히 액세스하고 작동될 수도 있습니다.
Liberty 정의 변수의 사용은 파일 경로를 표시하는 문자열을 사용하는 모든 서버 측 매개변수에서 허용됩니다. 이와 같은 변수는 liberty_home/README.TXT 파일에서 정의됩니다.
WebSphere:feature=scalingController,type=StackManager,name=StackManager
- 관리 인터페이스: com.ibm.websphere.scaling.controller.StackManager
- 주석: StackManager MBean이 파일 시스템 스캐닝을 제어합니다.
스택 관리자는 제어기의 추가, 수정 및 삭제를 위해 WLP_STACK_GROUPS_DIR
위치를 스캔하는데, 이것은 기본적으로
$WLP_USER_DIR/shared/stackGroups입니다. 다음 위치에서 MBean 클래스 및
API 문서를 찾을 수 있습니다.
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.scalingController_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.scalingController_version-javadoc.zip
WebSphere:name=com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- 관리 인터페이스: com.ibm.websphere.config.mbeans.ServerXMLConfigurationMBean
- 주석: ServerXMLConfigurationMBean은 서버에 알려진 모든
서버 구성 파일의 파일 경로를 검색하는 데 필요한 인터페이스를 제공합니다.
이 MBean은 커널에서 사용할 수 있으므로 특수
기능을 사용으로 설정하지 않아도 됩니다. 다음 위치에서 MBean 클래스 및
API 문서를 찾을 수 있습니다.
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_version-javadoc.zip
WebSphere:name=com.ibm.websphere.runtime.update.RuntimeUpdateNotificationMBean
- 관리 인터페이스: com.ibm.websphere.runtime.update.RuntimeUpdateNotificationMBean
- 주석: RuntimeUpdateNotificationMBean은 서버 런타임 업데이트에 대한 알림을 제공합니다. 알림에 첨부된 사용자 데이터 오브젝트는 java.util.Map입니다. 이 MBean이 생성하는 런타임 업데이트 알림의 알림 유형은 com.ibm.websphere.runtime.update.notification입니다.
WebSphere:name=com.ibm.ws.config.mbeans.FeatureListMBean
- 관리 인터페이스: com.ibm.websphere.config.mbeans.FeatureListMBean
- 주석: FeatureListMBean은 단일 메소드를 노출하여 런타임 시
설치된 모든 기능에 대한 XML 보고서를 생성합니다. 이 MBean은 커널에서 사용할 수 있으므로 특수
기능을 사용으로 설정하지 않아도 됩니다. 다음 위치에서 MBean 클래스 및
API 문서를 찾을 수 있습니다.
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_version-javadoc.zip
WebSphere:name=com.ibm.ws.config.serverSchemaGenerator
- 관리 인터페이스: com.ibm.websphere.config.mbeans.ServerSchemaGenerator
- 주석: ServerSchemaGenerator MBean은 메소드를 노출하여
설치된 이미지로부터(가장 많이 사용되는 방법) 또는 현재 런타임으로부터
스키마를 생성합니다. 이 MBean은 커널에서 사용할 수 있으므로 특수
기능을 사용으로 설정하지 않아도 됩니다. 다음 위치에서 MBean 클래스 및 API 문서를
찾을 수 있습니다.
- ${wlp.install.dir}/dev/api/ibm/com.ibm.websphere.appserver.api.config_version.jar
- ${wlp.install.dir}/dev/api/ibm/javadoc/com.ibm.websphere.appserver.api.config_version-javadoc.zip
WebSphere:name=com.ibm.ws.jmx.mbeans.generatePluginConfig
- 관리 인터페이스: com.ibm.websphere.webcontainer.GeneratePluginConfigMBean
- 주석: 웹 서버에 플러그인 구성 추가의 내용을 참조하십시오.
WebSphere:service=com.ibm.websphere.application.ApplicationMBean,name=*
- 관리 인터페이스: com.ibm.websphere.application.ApplicationMBean
- 주석: 시스템의 각 애플리케이션에 대해 인스턴스를 하나씩 사용할 수 있습니다. 여기서 *는 고유 애플리케이션 이름입니다.
WebSphere:service=com.ibm.websphere.webcontainer.WebModuleMBean,application=*,name=*
- 관리 인터페이스: com.ibm.websphere.webcontainer.WebModuleMBean
- 주석: 시스템의 각 WebModule에 대해 하나의 인스턴스를 사용할 수 있으며 application=*는 시스템에 있는 애플리케이션의 이름이고 name=*는 애플리케이션에 있는 웹 모듈의 이름입니다.
WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,*
- 관리 인터페이스: com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean
- 주석: 다음 컨텍스트에서 작성된 사항을 포함하여
시스템에서 각 연결 관리자에 대해 하나의 인스턴스를 사용할 수 있습니다.
- 서버 구성에서 명시적으로 구성된 경우
- @DataSourceDefinition 또는 @ConnectionFactoryDefinition 어노테이션으로 인해 암시적으로 작성된 경우
- 서버 구성에서 데이터 소스 또는 연결 팩토리의 결과로 작성된 경우
연결 관리자 인스턴스를 좁히기 위해 다음 예제에서 표시된 대로 추가 속성을 지정할 수 있습니다.WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,jndiName=jdbc/db2,* WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,name=jmsConnectionFactory[cf1]/connectionManager[default-0],* WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,name=databaseStore[dbstore1]/dataSource[default-0]/connectionManager,* WebSphere:type=com.ibm.ws.jca.cm.mbean.ConnectionManagerMBean,jndiName=java.module/env/jdbc/ds3,application=MyApp,module=myweb,*
WebSphere:service=com.ibm.ws.kernel.filemonitor.FileNotificationMBean
- 관리 인터페이스: com.ibm.websphere.filemonitor.FileNotificationMBean
WebSphere:type=JvmStats
- 관리 인터페이스: com.ibm.websphere.monitor.jmx.JvmMXBean
- 주석: monitor-1.0 기능이 사용하도록 설정된 경우에 제공됩니다. JVM 모니터링의 내용을 참조하십시오.
WebSphere:type=ServletStats,name=*
- 관리 인터페이스: com.ibm.websphere.webcontainer.ServletStatsMXBean
- 주석: monitor-1.0 기능이 사용하도록 설정된 경우 제공되는 각 서블릿에 대해 인스턴스를 하나씩 사용할 수 있습니다. 여기서 *는 <AppName>.<ServletName> 양식입니다. 웹 애플리케이션 모니터링의 내용을 참조하십시오.
WebSphere:type=ThreadPoolStats,name=Default Executor
- 관리 인터페이스: com.ibm.websphere.monitor.jmx.ThreadPoolMXBean
- 주석: monitor-1.0 기능이 사용하도록 설정된 경우에 제공됩니다. ThreadPool 모니터링의 내용을 참조하십시오.