diff --git a/content/v2.0/process-data/manage-tasks/create-task.md b/content/v2.0/process-data/manage-tasks/create-task.md index 5b4a797d4..c2e0753e5 100644 --- a/content/v2.0/process-data/manage-tasks/create-task.md +++ b/content/v2.0/process-data/manage-tasks/create-task.md @@ -2,8 +2,7 @@ title: Create a task seotitle: Create a task for processing data in InfluxDB description: > - How to create a task that processes data in InfluxDB using the InfluxDB user - interface or the `influx` command line interface. + Create a data processing task in InfluxDB using the InfluxDB UI or the `influx` CLI. menu: v2_0: name: Create a task @@ -64,7 +63,7 @@ The InfluxDB UI provides multiple ways to create a task: 3. Select **Import Task**. 4. Upload a JSON task file using one of the following options: - Drag and drop a JSON task file in the specified area. - - Click to upload and the area to select the JSON task from from your file manager. + - Click to upload and the area to select the JSON task from from your file manager. - Select the **JSON** option and paste in raw task JSON. 5. Click **Import JSON as Task**. diff --git a/content/v2.0/process-data/manage-tasks/delete-task.md b/content/v2.0/process-data/manage-tasks/delete-task.md index d31ef5655..f89b0981e 100644 --- a/content/v2.0/process-data/manage-tasks/delete-task.md +++ b/content/v2.0/process-data/manage-tasks/delete-task.md @@ -2,13 +2,12 @@ title: Delete a task seotitle: Delete a task for processing data in InfluxDB description: > - How to delete a task in InfluxDB using the InfluxDB user interface or using - the `influx` command line interface. + Delete a task from InfluxDB using the InfluxDB UI or the `influx` CLI. menu: v2_0: name: Delete a task parent: Manage tasks -weight: 205 +weight: 206 --- ## Delete a task in the InfluxDB UI diff --git a/content/v2.0/process-data/manage-tasks/export-task.md b/content/v2.0/process-data/manage-tasks/export-task.md index 66584cd9b..52fb52336 100644 --- a/content/v2.0/process-data/manage-tasks/export-task.md +++ b/content/v2.0/process-data/manage-tasks/export-task.md @@ -1,15 +1,15 @@ --- title: Export a task seotitle: Export an InfluxDB task -description: How to export a data processing task from InfluxDB using the InfluxDB user interface. +description: Export a data processing task from InfluxDB using the InfluxDB UI. menu: v2_0: name: Export a task parent: Manage tasks -weight: 204 +weight: 205 --- -InfluxDB allows you to export tasks from the InfluxDB user interface (UI). +InfluxDB lets you export tasks from the InfluxDB user interface (UI). Tasks are exported as downloadable JSON files. ## Export a task in the InfluxDB UI diff --git a/content/v2.0/process-data/manage-tasks/run-task.md b/content/v2.0/process-data/manage-tasks/run-task.md new file mode 100644 index 000000000..ec975adf7 --- /dev/null +++ b/content/v2.0/process-data/manage-tasks/run-task.md @@ -0,0 +1,41 @@ +--- +title: Run a task +seotitle: Run an InfluxDB task +description: > + Run a data processing task using the InfluxDB UI or the `influx` CLI. +menu: + v2_0: + name: Run a task + parent: Manage tasks +weight: 203 +--- + +InfluxDB data processing tasks generally run in defined intervals or at a specific time, +however, you can manually run a task from the InfluxDB user interface (UI) or the +`influx` command line interface (CLI). + +## Run a task from the InfluxDB UI +1. Click the **Tasks** icon in the left navigation to view the lists of tasks. + + {{< nav-icon "tasks" >}} + +2. Hover over the task you want to run and click the **{{< icon "gear" >}}** icon. +3. Select **Run Task**. + +## Run a task with the influx CLI +Use the `influx task run retry` command to run a task. + +{{% note %}} +To run a task from the `influx` CLI, the task must have already run at least once. +{{% /note %}} + +```sh +# List all tasks to find the ID of the task to run +influx task find + +# Use the task ID to list previous runs of the task +influx task run find --task-id=0000000000000000 + +# Use the task ID and run ID to retry a run +influx task run retry --task-id=0000000000000000 --run-id=0000000000000000 +``` diff --git a/content/v2.0/process-data/manage-tasks/task-run-history.md b/content/v2.0/process-data/manage-tasks/task-run-history.md new file mode 100644 index 000000000..ee4cae300 --- /dev/null +++ b/content/v2.0/process-data/manage-tasks/task-run-history.md @@ -0,0 +1,44 @@ +--- +title: View task run history and logs +description: > + View task run histories and logs using the InfluxDB UI or the `influx` CLI. +menu: + v2_0: + name: View run history + parent: Manage tasks +weight: 203 +--- + +When an InfluxDB task runs, a "run" record is created in the task's history. +Logs associated with each run provide relevant log messages, timestamps, +and the exit status of the run attempt. + +Use the InfluxDB user interface (UI) or the `influx` command line interface (CLI) +to view task run histories and associated logs. + +## View a task's run history in the InfluxDB UI + +1. Click the **Tasks** icon in the left navigation to view the lists of tasks. + + {{< nav-icon "tasks" >}} + +2. Hover over the task you want to run and click the **{{< icon "gear" >}}** icon. +3. Select **View Task Runs**. + +### View task run logs +To view logs associated with a run, click **View Logs** next to the run in the task's run history. + +## View a task's run history with the influx CLI +Use the `influx task run find` command to view a task's run history. + +```sh +# List all tasks to find the ID of the task to run +influx task find + +# Use the task ID to view the run history of a task +influx task run find --task-id=0000000000000000 +``` + +{{% note %}} +Detailed run logs are not currently available in the `influx` CLI. +{{% /note %}} diff --git a/content/v2.0/process-data/manage-tasks/update-task.md b/content/v2.0/process-data/manage-tasks/update-task.md index 20dba1432..255e35331 100644 --- a/content/v2.0/process-data/manage-tasks/update-task.md +++ b/content/v2.0/process-data/manage-tasks/update-task.md @@ -2,13 +2,12 @@ title: Update a task seotitle: Update a task for processing data in InfluxDB description: > - How to update a task that processes data in InfluxDB using the InfluxDB user - interface or the `influx` command line interface. + Update a data processing task in InfluxDB using the InfluxDB UI or the `influx` CLI. menu: v2_0: name: Update a task parent: Manage tasks -weight: 203 +weight: 204 --- ## Update a task in the InfluxDB UI diff --git a/content/v2.0/process-data/manage-tasks/view-tasks.md b/content/v2.0/process-data/manage-tasks/view-tasks.md index 76fb7b7c7..8aecb45e2 100644 --- a/content/v2.0/process-data/manage-tasks/view-tasks.md +++ b/content/v2.0/process-data/manage-tasks/view-tasks.md @@ -2,8 +2,7 @@ title: View tasks seotitle: View created tasks that process data in InfluxDB description: > - How to view all created data processing tasks using the InfluxDB user interface - or the `influx` command line interface. + View existing data processing tasks using the InfluxDB UI or the `influx` CLI. menu: v2_0: name: View tasks