Cloudera Docs

Enabling the Telemetry Publisher service

Activating the Telemetry Publisher service for Cloudera Observability.

Describes how to enable the Telemetry Publisher service for Cloudera Observability.
Verify that you have the following values before enabling the Telemetry Publisher service, as you will be required to supply their values during this task.
  • The Telemetry Publisher access credentials, which are required to register the Telemetry Publisher account.
  • The Databus endpoint EC2 service URL for your cloud region:
    • For a Us-west-2 cloud region use: 
      https://dbusapi.us-west-1.sigma.altus.cloudera.com
    • For a EU-central-1 cloud region use: 
      https://dbusapi.eu-1.cdp.cloudera.com
    • For a AP-southeast-2 cloud region use: 
      https://dbusapi.ap-1.cdp.cloudera.com
  1. In a supported web browser on a Workload cluster, log in to Cloudera Manager.
  2. In Cloudera Manager, select Clusters, locate and select Cloudera Management Service, and then select the Configuration tab.
  3. Search for the Telemetry Publisher Advanced Configuration Snippet (Safety Valve) for telemetrypublisher.conf property and in its text field, enter one of the following according to your cloud region using the Databus endpoint EC2 service URL that you recorded as a prerequisite for these steps:
    • For a Us-west-2 cloud region enter: 
      telemetry.upload.job.logs=true
telemetry.altus.url=https://dbusapi.us-west-1.sigma.altus.cloudera.com
    • For a EU-central-1 cloud region enter: 
      telemetry.upload.job.logs=true
telemetry.altus.url=https://dbusapi.eu-1.cdp.cloudera.com
    • For a AP-southeast-2 cloud region enter: 
      telemetry.upload.job.logs=true
telemetry.altus.url=https://dbusapi.ap-1.cdp.cloudera.com
  4. Click Save.
  5. Back in the Cloudera Manager Home page, from the navigation panel, select Administration and then External Accounts.
  6. In the External Accounts page, click the Altus Credentials tab, which displays your resource access account certificates.
  7. Add a new Telemetry Publisher access account certificate by clicking Add Access Key Authentication and then in the Add Access Key Authentication dialog box do the following:
    1. In the Name field, enter an identifiable name for the Telemetry Publisher access key account.
    2. In the Access Key ID field, enter the Telemetry Publisher access key text exactly as provided without trailing spaces.
    3. From the Private Key list, select Choose File and then browse and select your Telemetry Publisher private key file.
    4. Click Add, which saves the credentials as an Altus account certificate using the account name you provided and adds it on the Altus Credentials External Accounts page.
  8. Back in the Cloudera Manager Home page, from the navigation panel, select Administration and then Settings.
  9. Under the Filter CATEGORY section, select Altus.
    This populates the Settings page with your Telemetry Publisher access key accounts.
  10. From the Altus options, select the Telemetry Publisher Altus account certificate option that you require for this Workload Cluster. In this case, the name you provided in step 7a.
  11. Click Save Changes.
  12. Back in the Cloudera Manager Home page, in the Cloudera Management Service section at the bottom of the Status page, select Cloudera Management Service.
  13. In the Health Tests section, select Telemetry Publisher.
  14. From the Actions menu, select Start this Telemetry Publisher.
  15. In the Start message, confirm starting the Telemetry Publisher Service on your cluster by clicking Start.
  16. Monitor the progress until the Successfully started service message appears and then click Close.