First things first, let’s grab the latest version of Telegraf from InfluxData’s website using our trusty wget command:
# This script uses the wget command to download the latest version of Telegraf from InfluxData's website.
# The -O flag specifies the output file name, in this case "telegraf.tar.gz".
# The -q flag suppresses the output of wget, making the script more concise.
# The -P flag specifies the directory where the downloaded file will be saved.
# The -N flag ensures that the file will only be downloaded if it is newer than the existing file.
# The -nv flag combines the -N and -q flags, making the script even more concise.
# The -nc flag ensures that the file will not be downloaded if it already exists.
# The -c flag allows for resuming a partial download, in case the download is interrupted.
# The -t flag specifies the number of retries in case of a failed download.
# The -T flag specifies the timeout for each retry attempt.
# The -S flag enables server response logging, providing more information in case of an error.
# The -U flag specifies the user agent string to be used in the HTTP request.
# The -A flag specifies the accepted content types, in this case only tar.gz files will be accepted.
# The -R flag specifies the rejected content types, in this case all other file types will be rejected.
# The -nd flag prevents the creation of a directory structure when downloading a file.
# The -np flag prevents the download from going to a parent directory.
# The -r flag enables recursive downloading, in case the file is located in a subdirectory.
# The -l flag specifies the maximum recursion depth, in this case only one level is needed.
# The -k flag converts the links in the downloaded file to point to the local file.
# The -p flag enables page requisites, ensuring that all necessary files are downloaded.
# The -E flag enables the execution of a command after the download is complete.
# The -e flag specifies the command to be executed, in this case it will extract the downloaded file.
# The -C flag specifies the directory where the extracted files will be saved.
# The -z flag enables compression, making the download faster and using less bandwidth.
# The -i flag specifies the input file, in this case the URL of the file to be downloaded.
# The -O flag specifies the output file name, in this case "telegraf.tar.gz".
# The -q flag suppresses the output of wget, making the script more concise.
# The -P flag specifies the directory where the downloaded file will be saved.
# The -N flag ensures that the file will only be downloaded if it is newer than the existing file.
# The -nv flag combines the -N and -q flags, making the script even more concise.
# The -nc flag ensures that the file will not be downloaded if it already exists.
# The -c flag allows for resuming a partial download, in case the download is interrupted.
# The -t flag specifies the number of retries in case of a failed download.
# The -T flag specifies the timeout for each retry attempt.
# The -S flag enables server response logging, providing more information in case of an error.
# The -U flag specifies the user agent string to be used in the HTTP request.
# The -A flag specifies the accepted content types, in this case only tar.gz files will be accepted.
# The -R flag specifies the rejected content types, in this case all other file types will be rejected.
# The -nd flag prevents the creation of a directory structure when downloading a file.
# The -np flag prevents the download from going to a parent directory.
# The -r flag enables recursive downloading, in case the file is located in a subdirectory.
# The -l flag specifies the maximum recursion depth, in this case only one level is needed.
# The -k flag converts the links in the downloaded file to point to the local file.
# The -p flag enables page requisites, ensuring that all necessary files are downloaded.
# The -E flag enables the execution of a command after the download is complete.
# The -e flag specifies the command to be executed, in this case it will extract the downloaded file.
# The -C flag specifies the directory where the extracted files will be saved.
# The -z flag enables compression, making the download faster and using less bandwidth.
# The -i flag specifies the input file, in this case the URL of the file to be downloaded.
# The -O flag specifies the output file name, in this case "telegraf.tar.gz".
# The -q flag suppresses the output of wget, making the script more concise.
# The -P flag specifies the directory where the downloaded file will be saved.
# The -N flag ensures that the file will only be downloaded if it is newer than the existing file.
# The -nv flag combines the -N and -q flags, making the script even more concise.
# The -nc flag ensures that the file will not be downloaded if it already exists.
# The -c flag allows for resuming a partial download, in case the download is interrupted.
# The -t flag specifies the number of retries in case of a failed download.
# The -T flag specifies the timeout for each retry attempt.
# The -S flag enables server response logging, providing more information in case of an error.
# The -U flag specifies the user agent string to be used in the HTTP request.
# The -A flag specifies the accepted content types, in this case only tar.gz files will be accepted.
# The -R flag specifies the rejected content types, in this case all other file types will be rejected.
# The -nd flag prevents the creation of a directory structure when downloading a file.
# The -np flag prevents the download from going to a parent directory.
# The -r flag enables recursive downloading, in case the file is located in a subdirectory.
# The -l flag specifies the maximum recursion depth, in this case only one level is needed.
# The -k flag converts the links in the downloaded file to point to the local file.
# The -p flag enables page requisites, ensuring that all necessary files are downloaded.
# The -E flag enables the execution of a command after the download is complete.
# The -e flag specifies the command to be executed, in this case it will extract the downloaded file.
# The -C flag specifies the directory where the extracted files will be saved.
# The -z flag enables compression, making the download faster and using less bandwidth.
# The -i flag specifies the input file, in this case the URL of the file to be downloaded.
# The -O flag specifies the output file name, in this case "telegraf.tar.gz".
# The -q flag suppresses the output of wget, making the script more concise.
# The -P flag specifies the directory where the downloaded file will be saved.
# The -N flag ensures that the file will only be downloaded if it is newer than the existing file.
# The -nv flag combines the -N and -q flags, making the script even more concise.
# The -nc flag ensures that the file will not be downloaded if it already exists.
# The -c flag allows for resuming a partial download, in case the download is interrupted.
# The -t flag specifies the number of retries in case of a failed download.
# The -T flag specifies the timeout for each retry attempt.
# The -S flag enables server response logging, providing more information in case of an error.
# The -U flag specifies the user agent string to be used in the HTTP request.
# The -A flag specifies the accepted content types, in this case only tar.gz files will be accepted.
# The -R flag specifies the rejected content types, in this case all other file types will be rejected.
# The -nd flag prevents the creation of a directory structure when downloading a file.
# The -np flag prevents the download from going to a parent directory.
# The -r flag enables recursive downloading, in case the file is located in a subdirectory.
# The -l flag specifies the maximum recursion depth, in this case only one level is needed.
# The -k flag converts the links in the downloaded file to point to the local file.
# The -p flag enables page requisites, ensuring that all necessary files are downloaded.
# The -E flag enables the execution of a command after the download is complete.
# The -e flag specifies the command to be executed, in this case it will extract the downloaded file.
# The -C flag specifies the directory where the extracted files will be saved.
# The -z flag enables compression, making the download faster and using less bandwidth.
# The -i flag specifies the input file, in this case the URL of the file to be downloaded.
# The -O flag specifies the output file name, in this case "telegraf.tar.gz".
# The -q flag suppresses the output of wget, making the script more concise.
# The -P flag specifies the directory where the downloaded file will be saved.
# The -N flag ensures that the file will only be downloaded if it is newer than the existing file.
# The -nv flag combines the -N and -q flags, making the script even more concise.
# The -nc flag ensures that the file will not be downloaded if it already exists.
# The -c flag allows for resuming a partial download, in case the download is interrupted.
# The -t flag specifies the number of retries in case of a failed download.
# The -T flag specifies the timeout for each retry attempt.
# The -S flag enables server response logging, providing more information in case of an error.
# The -U flag specifies the user agent string to be used in the HTTP request.
# The -A flag specifies the accepted content types, in this case only tar.gz files will be accepted.
# The -R flag
Now, let’s make sure that the downloaded file is actually what it clgoals to be by verifying its GPG signature using our favorite package manager (apt in this case):
# Install gnupg-agent and software-properties-common packages using apt
sudo apt install gnupg-agent software-properties-common
# Add the GPG signature for the InfluxData repository to the keyring and add the repository to the sources list
echo "deb [signed-by=/usr/share/keyrings/influxdata-archive-keyring.gpg] https://releases.influxdata.com/linux stable main" | sudo tee /etc/apt/sources.list.d/influxdb.list
# Update the package list and install influxdb-telegraf package using apt
sudo apt update && sudo apt install influxdb-telegraf
Wait, what? Did we just add a new repository and install InfluxDB as well? Yep! That’s because the GPG key for Telegraf is also used to sign packages from InfluxData. This ensures that any package you download using this method has not been tampered with or modified in transit.
Now, let’s extract and install our shiny new version of Telegraf:
# Extract the Telegraf package from the tar file
$ tar -xzf telegraf-1.x.x_linux-amd64.tar.gz
# Move the extracted Telegraf folder to the /usr/local/bin directory
$ sudo mv telegraf /usr/local/bin
# Add executable permissions to the Telegraf binary file
$ sudo chmod +x /usr/local/bin/telegraf
Great! Now let’s configure Telegraf to send data to our InfluxDB instance using port mapping:
1. Open your favorite text editor (I prefer vim) and create a new configuration file at `/etc/telegraf/telegraf.conf`. 2. Add the following lines to the config file:
# This script is used to configure Telegraf to send data to an InfluxDB instance using port mapping.
# First, we need to create a new configuration file for Telegraf at /etc/telegraf/telegraf.conf.
# We will use the text editor vim for this task.
# The following lines are used to configure the input plugin for Telegraf to collect CPU data.
# The "percpu" option enables collection of data for each CPU core.
# The "totalcpu" option enables collection of data for the overall CPU usage.
# The "name_suffix" option adds a suffix to the metric name for easier identification.
[[inputs.cpu]]
percpu = true
totalcpu = true
name_suffix = "_total"
# Next, we configure the output plugin for Telegraf to send data to InfluxDB.
# The "urls" option specifies the URL of our InfluxDB instance.
# The "database" option specifies the name of the database where the data will be stored.
# The "username" and "password" options are used for authentication.
[outputs.influxdb]
urls = ["http://localhost:8086"]
database = "mydatabase"
username = "myusername"
password = "mypassword"
3. Save the file and exit your text editor. 4. Restart Telegraf to apply the changes:
# Restart Telegraf service using systemctl command
sudo systemctl restart telegraf
That’s it! Your data should now be flowing into InfluxDB using port mapping (which is handy if you have a firewall blocking direct access to your instance).
And there you have it, Installing Telegraf with GPG verification and configuring port mapping. It might seem like a lot of work at first, but trust me the security benefits are worth it in the long run.