Skip to main content
Feedback

Adding New Call Log Export

Procedure

  1. Navigate to Analyze > Call Log Exports. This opens the Manage your Call Log Exports page.

  2. Click New Call Log Export. This opens the New Call Log Export pop-up window.

    1. In Call Log Export Name, enter the call log export profile name.

      This name can contain spaces, special characters, and alphanumeric characters. It should indicate the type of configuration — for example, Test Call Log Export, Test_Call_Log_Export, or Call-Export-1.

      note

      After you save the configuration, you can edit this field later. The value must be unique.

    2. In S3 Bucket Name, enter your S3 bucket name and path (if applicable) where the call log files will be delivered.

      For example, bucketName or bucketName/additionalPath are valid entries. URL schemes are not accepted. For example, s3://bucketName or https://bucketName/additionalPath are not allowed.

      • Click the setup instructions link on the New Call Log Export pop-up window for more information about configuring your AWS account before creating or updating an ECLE profile. This opens the Call Log Export set up instructions. Click Back to return to the New Call Log Export window.

    3. In IAM Role Arn, enter IAM role Arn to refer to this export definition within the Call Log Export feature.

    4. In CMK Key Arn, enter CMK key Arn to refer to this export definition within the Call Log Export feature.

    5. In IAM Role External Id, enter the External ID required to assume the specified IAM role.

    6. In Mask sensitive data, enable the toggle switch to activate masking of sensitive data, such as API keys or OAuth tokens.

    7. In Number of characters to leave unmasked, select a value from the list.

      info

      This field appears when the Mask sensitive data toggle switch is enabled.

      The valid values range from 0 - 127. A value of 0 masks the entire string. For example, if you leave 3 characters unmasked and the data value is 0123456789, the resulting masked value will be 012\*\*\*\*789.

    8. In Collect calls starting from this date and time, select the date and time when call collection should begin.

      The Start time must be in the future. All dates/times are in UTC. Call log export snaps the selected time to the nearest hour. For example, 2025-03-21T06:57:00.000+000 snaps to 2025-03-21T07:00:00.000+000

      warning

      Once you save the configuration, you cannot edit this field.

    9. Optional: In Collect calls up until this date and time, select the date and time for data collection to stop. Any future date is allowed, provided it is later than the start date. No end date results in the export running until the profile is disabled or deleted.

      warning

      Once you save the configuration, you cannot edit this field.

    10. In Call Log Export Filter Criteria, specify the type of calls to capture in the Call Log Export log file that is delivered to your S3 bucket.

      note

      If no filters are set, all data will be included in the export. Use filters to explicitly include or exclude data based on your criteria.

      Provide the following details:

      1. In Field, select API Definition, API Key, or Response Code.

      2. In Operator, select is or is not.

      3. In Value, enter the appropriate value and then click the Add (+) icon.

        The call log export filter is added to the list. Repeat the above steps to add additional filters, but you cannot edit filters after creating a profile.

        important

        When creating the first filter in the Call Log Export Filter Criteria field:

        • If your first filter uses is logic, you can only add additional is logic filters.

        • If your first filter uses is not logic filter, you can only add additional is not logic filters.

        • You cannot add both is and is not logic filters within the same filter field type, though you can use different operators across different field types.

        For example, you can use is on the API Key field and is not on the Response Code field. When use multiple field types in a filter, the And operator is used in the filter across field types.

    11. Click Save and continue.

    12. Click View Settings or Close to return to the Settings page.

Result

Once the Call Log Export profile is configured and enabled, Control Center generates the raw call logs and exports them as .gz files into the Amazon S3 bucket. You can then export the data to Splunk, another database, or business intelligence software for further analysis.

important

Your first export may take up to 2.5 hours to arrive in your S3 bucket.

On this Page