The CLI estimate interactions command

Abstract

Describes the xConnect DevEx CLI estimate interactions command that estimates the number of interactions deleted in a purge.

The xConnect DevEx CLI plugin includes a purge command with an interactions subcommand. This command estimates the number of interactions a purge process would delete based on the provided StartedDaysCutoff and options.

You can use the command as follows:

sitecore xconnect estimate interactions [options]

You can use the following options with the command:

Option

Required?

Description

-c, --config

Yes

The path to the sitecore.json configuration file (default: cwd). A DevEx CLI standard option.

-n, --environment-name

Yes

The Sitecore environment to use. Default: default. A DevEx CLI standard option.

-d, --started-days-cutoff

Yes

The started-days-cutoff option specifies the number of days since the interaction started. This option filters interactions based on its StartDateTime value. The StartDateTime value reflects the interaction's starting DateTime. For example, -d 190.

Note

This option is the only requirement with no default value.

There is a list of restrictions for the started-days-cutoff option:

--sp, --start-percentile

No

The range-bound start percentile for the data extraction. For example, --sp 0.

There is a list of restrictions for the start-percentile option:

  • You must specify both the start and end percentile or none of them.

  • The range-bound for both is between 0 and 1.

  • The start-percentile must be lower than the end-percentile.

--ep, --end-percentile

No

The range-bound end percentile for data extraction. For example, --ep 1.

There is a list of restrictions for the end-percentile option:

  • You must specify both the start and end percentile or none of them.

  • The range-bound for both is between 0 and 1.

  • The end-percentile must be higher than the start-percentile.

-v, --verbose

No

Report additional diagnostic and performance data.

-t, --trace

No

Report additional diagnostic and performance data.

-?, -h, --help

No

Help for the xconnect estimate interactions command.

Examples

The following are examples of the estimate interactions command use:

sitecore xconnect estimate interactions -d 180

sitecore xconnect estimate interactions -d 200 --sp 0.2 --ep 0.6 -n test --trace
--verbose