Adjusting Application.yml for Celonis Agent
Responsibility: Server/ infrastructure administrator (supported by Celonis team administrator)
Later Changes
It is still possible to change the name of the Agent and the limit of concurrent executions (Agent in general and SAP exclusively) after setting up the Agent (Advanced application.yml configuration).
The Celonis Agent comes in a zip file together with a “application.yml” file which stores the configuration needed to register the Agent in the Celonis team.
A Celonis team administrator has to provide the application key. The server/ infrastructure administrator has to update and save the application.yml file in the Agent package.
Configuration of application.yml file for Celonis Agent
The application.yml file that is part of the Celonis Agent package needs to be configured. Please see an example below:
application.yml
agent:
name: # required; change to prefered name
cloud:
celonis:
app-key: #required; Celonis team Admin must create the app-key. Use this app-key here.
teamDomain: #required
env: #realm where the team is located; this can be eu-1, eu-2, us-1, us-2,...
proxy: # if in the host where agent is deployed outbound requests are not allowed and have to go through a proxy, please add the proxy details in this configuration
enabled: false # false or true
protocol: # proxy protocol (http, https), default https
host: # proxy host, required if proxy enabled
port: # proxy port, optional
user: # proxy user, optional
password: # proxy password, optional
Example
Please see an example of a fully configured application.yml file below:
Example of a fully configured application.yml file
agent: name: agent-007 # required; change to prefered name id: 12234-5556777... cloud: celonis: app-key: OWZjMjdiOTAtZmJjKLjkweoisd89KKLJJilkSeV67219KKjpR... teamDomain: testteam env: eu-1 proxy: enabled: true protocol: http host: proxyhost.test.com port: 8090 user: user1 password: lwe&roi...
Spaces
Make sure that there is always at least one blank space before the comments starting with "#".
Incorrect: "name: agent-007#required"
Correct: "name: agent-007 #required"
Communication from Celonis Agent
The destination URL of requests originating from Celonis Agent is: https://<teamDomain>.<env>.celonis.cloud/*
e.g. https://testteam.eu-1.celonis.cloud/*
Advanced application.yml configuration
Adjust concurrent executions limit and activate additional logs
There are some additional configuration options that can be used in the application.yml if required.
Example to limit Agent concurrent executions
agent: name: agent-007 # required; change to prefered name id: 12234-5556777... concurrent-executions: 200 # you can adjust the number of concurrent executions, default: 100
Enable Logs for Debugging
Example to change logging settings
logging: level: debug # you can enable additional logs for the agent, these can be helpful when debugging errors, default: disabled
Rename the Agent
You can rename the Agent by following the steps below:
Open the yml file
Adjust the name
Delete the id row
Restart the Agent
Example to change name
agent: name: agent-007
The Agent will then register with the new name and a new id will be automatically created
Please note that the update can take some time before being effective.
Note
Please make sure to update the Skills which are using the Agent accordingly and reselect the right Agent in the Agent dropdown.
 |
Adjust concurrent executions limits for SAP
To limit the SAP executions adjust the limit
Example to limit SAP concurrent executions
sap:
client:
concurrent-executions: <value> # you can adjust the number of concurrent SAP executions, default: 100