Delphix Telemetry

Overview

Delphix Telemetry encompasses two critical functions—registering your Data Control Tower (DCT) installation to a Delphix account, then uploading telemetry exports to the Delphix Telemetry services. This integration helps Delphix better understand product usage to enhance your support experience. Delphix Telemetry has an online and offline model.

Online model

  • Requires internet connectivity.

  • Registration and telemetry are simultaneously configured.

  • Automatically uploads telemetry data daily.

Offline model

  • Does not require internet connectivity.

  • Registration must be performed manually, once.

  • Exports must be uploaded manually, typically quarterly.

You can view Delphix Telemetry service status at: status.delphix.com. Delphix Telemetry is maintained within Delphix Compliance Services (DCS).

All DCT tiers (Core, Self Service, and Enterprise) and all deployment types (Kubernetes, OpenShift, and Appliance) support this capability.

Online registration and export upload

Follow these steps to register your DCT product and automatically upload the Telemetry export.

  1. Complete and submit this form to request your Delphix Compliance Services (DCS) Account.

  2. Within 24-48 hours, check your email for account creation instructions and create your password.

  3. Log in to your Data Control Tower instance.

  4. Navigate to Admin > Telemetry.

  5. Click Register in the top right.

  6. Enter your new DCS credentials and submit.

  7. Upon successful verification, click Register DCT.

  8. Your DCT installation is now registered. Exports are uploaded automatically every 24 hours. Confirm the last upload time in the Details section of the home DCT page.

Note: If your credentials change, repeat these steps to re-register.

Offline registration and export upload

Choose this method if your DCT installation lacks internet connectivity or you prefer manual uploads.

  1. Complete and submit this form to request your Delphix Compliance Services (DCS) account.

  2. After 24-48 hours, use the email instructions to finalize the account setup.

  3. Generate an API Token:

    1. Log in to DCS.

    2. Navigate to Accounts > API Tokens, and follow the instructions to add a token. More details can be found in the Programmatic access to DCS (API Tokens) page.

    3. Save your generated API Token securely. This token will be required for each offline export upload.

  4. Log in to DCT.

  5. Navigate to Admin > Telemetry.

  6. Click Register, then select Switch to Offline Registration.

  7. Copy the provided Product ID and Public Key.

  8. In your terminal, run:

Copy 
curl --request POST \
                --url 'https://api.apps.delphix.com/v1/telemetry/register' \
                --header 'Authorization: Bearer <DCS_ACCOUNT_TOKEN>' \
                --header 'Content-Type: application/json' \
                --data '{
                "uuid": "<DCT_PRODUCT_ID>",
                "key": "<DCT_PUBLIC_KEY>"
            }'

You will receive key and token values in the response. Enter these into the respective fields in DCT.

Submit to complete offline registration. Verify successful registration status directly in the DCT UI.

Offline export upload

  1. Log in to DCT, navigate to Admin > Registration, and select Download export.

  2. Choose a date range or leave as default for a comprehensive export.

  3. Prepare upload location by running in your terminal:

Copy 
curl --request POST \
                --url 'https://api.apps.delphix.com/v1/telemetry/initiate' \
                --header 'Authorization: Bearer <DCS_ACCOUNT_TOKEN>' \
                --header 'Content-Type: application/json' \
            --data '{"uuid": "<DCT_PRODUCT_ID>"}'

Use the response values to execute the following command and upload your export. Ensure careful replacement of placeholders (e.g., <AWS_UPLOAD_URL>, <AWS_KEY>, etc.) as incorrect substitutions will cause upload errors:

Copy 
curl -X POST "<AWS_UPLOAD_URL>" \
                --form "key=<AWS_KEY>" \
                --form "x-amz-algorithm=<AWS_ALGORITHM>" \
                --form "x-amz-credential=<AWS_CREDENTIAL>" \
                --form "x-amz-date=<AWS_DATE>" \
                --form "x-amz-security-token=<AWS_SECURITY_TOKEN>" \
                --form "x-amz-signature=<AWS_SIGNATURE>" \
                --form "policy=<AWS_POLICY>" \
            --form "file=@<DCT_BUNDLE_FILE_PATH>"

A successful upload returns a 204 status which can be confirmed by using the -v verbose argument. Retain the confirmation response or take a screenshot for record-keeping and audit purposes.

Note: We request you to upload exports periodically and as directed by your account team. To switch to the online model, simply follow the Online Registration process again.

Proxy configuration

If you or your DCT instance is behind a firewall and a proxy server needs to be configured to enable online communication with the Delphix Telemetry service, then open the following URLs:

  • api.apps.delphix.com: Registers the DCT instance with the Delphix Telemetry service and retrieve the dynamic AWS bucket URL and signature for export upload.

  • s3-us-west-2.amazonaws.com: Validates connectivity to the AWS S3 bucket for uploads.

  • 081755927184-us-west-2-prod-telemetry.s3.amazonaws.com: The AWS S3 bucket where the telemetry export is uploaded.

All communication occurs over HTTPS, port 443.

FAQs

I filled out the form for a Delphix Compliance Services (DCS) account, but did not receive any follow-up emails. Where is it?

  • Once you request an account, it can take up to two (2) business days to receive a follow-up email containing next steps. If you do not see this email, please check your spam filters or IT email rules for emails from “noreply@apps.delphix.com”.

  • If you still have not received the email, please contact your Delphix Account Team.

How does Delphix use the data gathered by Telemetry? How is it secured?

  • Telemetry bundles contain metadata critical to analyzing product use, improving functionality, and enhancing security. Please review the documentation for specifics on data collected and its usage in analytics at Delphix Telemetry: Data and usage.

  • Delphix remains committed to transparency regarding data privacy and security.