- 15 Nov 2022
- 2 Minutes to read
- PDF
Virtual Machine
- Updated on 15 Nov 2022
- 2 Minutes to read
- PDF
Traceable's Platform agent is an agent that receives various information from different Tracing agents. The Platform agent is deployed between a Tracing agent and Traceable Platform and works to collect data. It also works to classify data along with redacting the data. The Platform agent makes sure that no sensitive information reaches Traceable Platform. The Platform agent receives the blocking rule information from Traceable Platform and further sends it to the instrumentation agent.
The document details steps to install Traceable agent on virtual machines having one of the following two operating systems:
- Amazon Linux 2 (CentOS)
- Ubuntu
Prerequisites
You would require an Agent token to proceed with Platform agent installation. Complete the following steps to generate a unique Agent token:
- Log in to your Traceable account.
- Navigate to Administration (
) > Account > Agent Tokens.
- Click on Generate Token.
Make sure to copy and save the generated token as you cannot access it again. You can only edit the name of the token or delete it. This token is used in steps detailed below. If this token is deleted from Traceable Platform (UI), the communication between Traceable Platform agent and Traceable Platform (UI) will break. In such a case, generate a new token and update the same in Platform agent.
Amazon Linux 2 (CentOS)
The set of instructions are compatible with Amazon Linux 2 (CentOS). Complete the following steps to install Traceable agent:
- Setup the repository
- Select the version of Traceable agent
- Install Traceable agent
- Configure Traceable agent
- Start Traceable agent
- Verify installation
Setup the repository
Enter the following command to set up the Traceable repo:
sudo vi /etc/yum.repos.d/traceable.repo
Paste the following contents (type i
to enter edit mode)
rpm -E %{rhel}
to fetch the CentOS version.In the following sample snippet, in baserul
, replace the centos[7/8]
with the required version of CentOS as shown in the example.
[traceable]
name=Traceable repository
baseurl=https://packages.traceable.ai/centos[7|8]/
enabled=1
gpgcheck=0
For example,
[traceable]
name=Traceable repository
baseurl=https://packages.traceable.ai/centos7/
enabled=1
gpgcheck=0
Hold down Shift
+ ZZ
to exit Vi editor.
Install Traceable
sudo yum install traceable
Configure Traceable
- Set the refresh token
Add the refresh token to the file below. This is the token that you had copied and saved in the Prerequisite section.
sudo vi /etc/traceable/agent/token
Type Shift
+ ZZ
to exit vi.
- Reload systemd
Enter the following command to reload the systemd service:
sudo systemctl daemon-reload
- Set the environment variable
Enter the following command to set the environment variable:
sudo systemctl edit traceable
Enter the following then exit the editor:
[Service]
Environment="TA_ENVIRONMENT=<expected environment>"
Start Traceable
Enter the following command to start Traceable agent:
sudo systemctl start traceable
Add Traceable to the system startup
sudo systemctl enable traceable && sudo systemctl restart traceable
Verify installation
Enter the following command to verify a successful installation of the Traceable agent:
systemctl is-active traceable
Ensure no ERROR
logs are present and a Started metric exporter
message appears in the logs
cat /var/traceable/log/traceable.YYYY_mm_dd_ss_mil.log
Ubuntu
The set of instructions to install Traceable agent are compatible with Ubuntu 18.04 and 20.04. Complete the following steps to install Traceable agent:
- Setup the repository
- Install Traceable agent
- Configure Traceable agent
- Start Traceable agent
- Verify installation
Setup Repository
sudo apt-get update
sudo apt-get install -y ca-certificates
sudo echo "deb [trusted=yes] https://packages.traceable.ai/ubuntu/ focal main" | sudo tee -a /etc/apt/sources.list.d/traceable.list
sudo apt-get update
Install Traceable
sudo apt-get install -y traceable
Configure Traceable
Configuring Traceable involves the following two steps:
- Editing the
config.yaml
file - Reloading
systemd
service
Set the refresh token
Add the refresh token to the file below
sudo vi /etc/traceable/agent/token
Reload systemd
Enter the following command to reload the systemd service:
sudo systemctl daemon-reload
Set the environment variable
Enter the following command to set the environment variable:
sudo systemctl edit traceable
Enter the following then exit the editor:
[Service]
Environment="TA_ENVIRONMENT=<expected environment>"
Enter the following command to start the Traceable agent:
sudo systemctl start traceable
Add Traceable to the system startup
Enter the following command to add Traceable agent to systemd startup:
sudo systemctl enable traceable && sudo systemctl restart traceable
Verify installation
Enter the following command to verify a successful installation of Traceable agent:
systemctl is-active traceable
Ensure no ERROR
logs are present and a Started metric exporter
message appears in the logs
cat /var/traceable/log/traceable.YYYY_mm_dd_ss_mil.log