180.4. Camel에서 Cryostat 활성화

기본적으로 Cryostat 계측 에이전트는 Camel에서 활성화됩니다. 즉 Camel 런타임이 VM의 Cryostat Server 인스턴스로 management 오브젝트를 생성하고 등록합니다. 이를 통해 Camel 사용자는 Camel 경로가 개별 프로세서 수준으로 작동하는 방법에 대한 정보를 즉시 얻을 수 있습니다.

지원되는 관리 오브젝트 유형은 끝점,경로,서비스 및 프로세서 입니다. 이러한 관리 오브젝트 중 일부는 성능 카운터 속성 외에도 라이프사이클 작업을 노출합니다.

DefaultManagementNamingStrategy 는 Cryostat 등록에 사용되는 오브젝트 이름을 빌드하는 기본 이름 지정 전략입니다. 기본적으로 org.apache.camel 은 CamelNamingStrategy 에서 생성한 모든 오브젝트 이름의 도메인 이름입니다. Cryostat 오브젝트의 도메인 이름은 Java VM 시스템 속성으로 구성할 수 있습니다.

-Dorg.apache.camel.jmx.mbeanObjectDomainName=your.domain.name

또는 Spring 구성의 camelContext 요소 내에 jmxAgent 요소를 추가하여 다음을 수행합니다.

<camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
  <jmxAgent id="agent" mbeanObjectDomainName="your.domain.name"/>
    ...
</camelContext>

Spring 구성은 둘 다 있는 경우 시스템 속성보다 우선합니다. 이는 모든 Cryostat 관련 구성에 적용됩니다.

다음과 같이 Java VM 시스템 속성을 설정하여 Cryostat 계측 에이전트를 비활성화할 수 있습니다.

-Dorg.apache.camel.jmx.disabled=true

속성 값은 부울 로 처리됩니다.

또는 Spring 구성의 camelContext 요소 내에 jmxAgent 요소를 추가하여 다음을 수행합니다.

<camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
  <jmxAgent id="agent" disabled="true"/>
    ...
</camelContext>

또는 Camel 2.1 에서는 다음과 같이 순수 Java를 사용하는 경우(JVM 시스템 속성을 사용하지 않아도) 약간 더 쉽습니다.

CamelContext camel = new DefaultCamelContext();
camel.disableJMX();

각 CamelContext는 InstrumentationLifecycleStrategy 내부에 래핑된 InstrumentationAgent 인스턴스를 포함할 수 있습니다. InstrumentationAgent는 /register Camel의 등록/등록 취소를 위해 Server 와 상호 작용하는 오브젝트입니다. 여러 CamelContexts / InstrumentationAgents can / should share a Cryostat Server. 기본적으로 Camel 런타임은 Cryostat Server Factory.findMBeanServer 메서드에서 반환된 첫 번째 CryostatServer를 선택합니다. 이 메서드는 org.apache.camel 의 기본 도메인 이름과 일치합니다.

애플리케이션에서 이미 사용하고 있는 경우 기본 도메인 이름을 변경하여 이미 사용하고 있는 Server 인스턴스와 일치해야 할 수 있습니다. 특히 Cryostat Server 가 Cryostat 커넥터 서버에 연결된 경우 Camel에서 커넥터 서버를 생성할 필요가 없습니다.

시스템 속성을 통해 일치하는 기본 도메인 이름을 구성할 수 있습니다.

-Dorg.apache.camel.jmx.mbeanServerDefaultDomain=<your.domain.name>

또는 Spring 구성의 camelContext 요소 내에 jmxAgent 요소를 추가하여 다음을 수행합니다.

<camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
  <jmxAgent id="agent" mbeanServerDefaultDomain="your.domain.name"/>
    ...
</camelContext>

일치하는 Cryostat Server 를 찾을 수 없는 경우 새 도메인 이름이 생성되고 위에서 언급한 대로 기본 및 구성에 따라 새 'MBeanServer'의 기본 도메인 이름이 설정됩니다.

시스템 속성을 설정하여 JVM Cryostat를 관리하는 것이 바람직한 경우 PlatformMBeanServer 를 사용할 수도 있습니다. CryostatServer 기본 도메인 이름 구성은 적용되지 않으므로 무시됩니다.

-Dorg.apache.camel.jmx.usePlatformMBeanServer=True

또는 Spring 구성의 camelContext 요소 내에 jmxAgent 요소를 추가하여 다음을 수행합니다.

<camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
  <jmxAgent id="agent" usePlatformMBeanServer="true"/>
    ...
</camelContext>

아래 섹션의 시스템 속성: jmxAgent 속성 참조를 참조하십시오.

JDK의 Cryostat에는 인증을 위한 기능과 SSL을 통해 보안 연결을 사용하는 기능도 있습니다. 이를 사용하는 방법에 대한 자세한 내용은 SUN 문서를 참조하십시오.

Spring 구성 파일을 사용하면 Camel이 관리를 위해 Cryostat에 노출되는 방법을 구성할 수 있습니다. 커넥터의 포트 또는 경로 이름과 같이 여기에서 더 많은 정보를 지정할 수 있는 경우도 있습니다.

<camelContext id="camel" xmlns="http://camel.apache.org/schema/spring">
  <jmxAgent id="agent" createConnector="true" registryPort="2000" mbeanServerDefaultDomain="org.apache.camel.test"/>
    <route>
      <from uri="seda:start"/>
      <to uri="mock:result"/>
    </route>
</camelContext>

Java 5 Cryostat 설정을 변경하려면 다양한 Cryostat 시스템 속성을사용할 수 있습니다.

예를 들어 다음 환경 변수(플랫폼에 따라 설정 또는 내보내기 )를 설정하여 Sun#159 커넥터에 대한 원격 Cryostat 연결을 활성화할 수 있습니다. 이러한 설정은 Camel이 기본적으로 생성하는 Cryostat 커넥터가 아닌 Java 1.5+ 내에서만 Sun Cryostat 커넥터를 구성합니다.

SUNJMX=-Dcom.sun.management.jmxremote=true -Dcom.sun.management.jmxremote.port=1616 \
-Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false

(SUNJMX 환경 변수는 Camel에 대한 시작 스크립트에서 JVM의 추가 시작 매개 변수로 사용하기 쉽습니다. Camel을 직접 시작하는 경우 이러한 매개변수를 직접 전달해야 합니다.)

Camel 2.7부터 사용 가능

Camel은 이제 mbeans 등록 여부를 제어하는 두 가지 설정을 제공합니다.

기본적으로 Camel은 시작 시 구성된 모든 경로에 대해 등록합니다. registerNewRoutes 옵션은 새 경로를 추가하는 경우 등록되어야 하는 경우 제어합니다. 예를 들어 관리가 필요하지 않은 임시 경로를 추가하고 제거하는 경우 이 기능을 비활성화할 수 있습니다.

수신자 목록에 고유한 엔드포인트가 있는 것과 같은 동적 EIP 패턴을 사용할 때 registerAlways 옵션을 사용해야 합니다. 이렇게 하면 각 엔드포인트와 관련 서비스/프로덕터도 등록됩니다. 이로 인해 레지스트리의 mbeans 수가 증가하여 시스템 중단이 발생할 수 있습니다. ScanSetting은 경량 개체가 아니므로 메모리를 사용합니다.