Java agent for Weblogic monitoring

For supported agent versions and framework, see APM agents.

Downloading the agent version 1.18.4 (latest)

  1. Download the agent tar file from the link.
curl --header "PRIVATE-TOKEN:{{TOKEN}}" --output sixthsense-agent.zip "https://artifacts-observability.sixthsense.rakuten.com/api/v4/projects/4/packages/generic/sixthsense/v1.18.4-latest/agent.zip"
  1. Unzip the agent in any location. This location must be provided in the JVM arguments.

Configuring the agent

Update the following parameters in the agent.config file in the agent/config folder.

agent.service_name= APPLICATION_NAME
agent.force_tls= true
collector.backend_service =grpc-collector-observability.sixthsense.rakuten.com:443
agent.authentication = TOKEN_FROM_SIXTHSENSE_UI

For OneCloud Platform use the following command:

agent.service_name= APPLICATION_NAME
agent.force_tls=${SW_AGENT_FORCE_TLS:false}
# For connectivity to backend using intra public network:
collector.backend_service = 133.237.176.44:80
# For connectivity to backend using onecloud private network:
collector.backend_service=${SW_AGENT_COLLECTOR_BACKEND_SERVICES:100.99.116.221:80}
agent.authentication = TOKEN_FROM_SIXTHSENSE_UI

To integrate the agent to the application, navigate to the bin directory of your domain.

Example:

~/Oracle/Middleware/Oracle_Home/user_projects/domains/wl_server/bin

In the following file, replace the line with the path to the sixthsense-agent in the weblogicstartup.sh file.

-- debugpatchAgent="-javaagent:${WL_HOME}/server/lib/debugpatch-agent.jar"
export AGENT_HOME=<path where agent is unzipped>
++ debugpatchAgent="-javaagent:${AGENT_HOME}/agent/sixthsense-agent.jar -Xbootclasspath/a:-${AGENT_HOME}/agent/plugin"

Following is another approach:

In the setStartupEnv.sh (for linux) and setStartupEnv.bat (for windows) files, set the following line.

export JAVA_OPTIONS=$JAVA_OPTIONS -javaagent:"<path where agent is unzipped>/agent/sixthsense-agent.jar" -Xbootclasspath/a:"<path where agent is unzipped>/agent/plugin"

Restart the server (Weblogicstartup.sh), and monitor the logs.

tail -f ${AGENT_HOME}/agent/skywalking-api.log
note

For Windows based applications, if the arguments to the application are passed from a windows registry service, then you need to pass the agent in those arguments in order to integrate the agent.