Cloud Services

Cost & Asset Management

Managing Jobs
Published On Aug 26, 2024 - 1:26 PM

Managing Jobs

Learn how to manage data ingestion per job to ensure the most current data is available.
This page details how to manage data ingestion jobs, including the steps for viewing and cancelling jobs. The user can also find steps for viewing tag remediation jobs, canceling tag remediation jobs, and scheduling jobs.

Manage data ingestion jobs

Job service, by default, is disabled. To enable a job and update the frequency, complete the following steps:
  1. To learn more about navigating to the different services from each tenant, refer to Landing page navigation or Kyndryl Bridge Landing page navigation. For the application select
    core > cb-core-job-service
    .
  2. Get the list of jobs that is registered for the tenant, and look for
    ecam-ingestion-
    tenant-id
    . Use the following API, GET /core/jobmanagement/v1/jobdefinitions.
  3. Enable the ingestion job for the tenant by patching it with the following data in the payload. Use the following API, PATCH /core/jobmanagement/v1/jobdefinitions/job_definition/{job_definition_id}/icb_application/{icb_application}. For this example, this job runs every day at 18:30.
    { "status": "Active", "scheduled_at": "30 18 * * *" }
Data Ingestion and Normalization: Cost and Asset Management uses Artificial Intelligence/Machine Learning to detect anomalies in the duration of cost data ingestion jobs and generates alert notifications when jobs exceed past results.

Viewing jobs

Use the Job List table to view detailed information about a job. Complete the following steps to view job details:
  1. Select
    Jobs
    from the list to open the Job List screen.
The Job List screen is displayed and presents two tabs:
Ingestion
and
Recommendation
.
  • Ingestion Tab:
    Data in this table reflects the ID, start and end dates, duration, type, and status of the jobs for all jobs related to ingestion by provider.
    • To see details for a specific job, click the row for that job.
    • The Job Details screen is displayed and it shows the status of the job. The status is processed in the following three steps:
      • Queued
      • In Progress
      • Final step - which can be one of the following:
        Completed
        ,
        Failed
        ,
        Running
        ,
        Partial Success
        , and
        Stopped
        .
    • To see billing account status details, click the drop-down icon for each job status.
      • This screen reflects the ID, status, and error information.
  • Recommendation Tab:
    Data in this table reflects the ID, start and end dates, duration, type, and status of the jobs for all jobs related to insights.
    • To see details for a specific job, click the row for that job.
    • The Job Details screen is displayed and it shows the status of the job. The status is processed in the following three steps:
      • Queued
      • In Progress
      • Final step - which can be one of the following:
        Completed
        ,
        Failed
        ,
        Running
        ,
        Partial Success
        , and
        Stopped
    • To see billing account status details, click the drop-down icon for each job status.
      • This screen reflects the task ID, run duration, start, last updated, status, and error information.
An error is displayed in the
error column
only when the billing account is invalid. When a job is in progress, a
Terminate
button appears in the upper right corner of the page. Click the
Terminate
button to terminate the job.

Cancelling jobs

Only one ingestion job can run at a time. If a new job is required to run, you must cancel the previous job first. To cancel a job, use the following API, POST /api/ecam/v1/enrichmentController/jobs/terminate. You can find this API by clicking the
User
icon in the top-left of the Kyndryl Modern Operations Applications landing page and select
Developer Console
. For the application select
ecam > ecam-orc
.
The user must first set the force flag to
false
with the jobId as part of the payload, for example:
{ jobId: "tenant1:*tenant id**", "force": false }
You must set the force flag to
true
with the jobId as part of the payload, for example:
{ jobId: "tenant1:*tenant id**", "force": true }

Tag remediation jobs

Viewing Tag remediation jobs

Use the Job List table to view detailed information about a job. Complete the following steps to view job details:
  1. Select
    Tag remediation Jobs
    from the list to open the Job List screen.
The Job List screen is displayed and presents with a table which contains Job ID, Start Date, End Date, Job Type, and Status.
To see details for a specific job, click the row for that job.
  1. The Job Details screen is displayed and it shows the status of the job. The status is processed in the following three steps:
    • Queued
    • In Progress
    • Final step - which can be one of the following:
      Completed
      ,
      Failed
      ,
      Running
      ,
      Partial Success
      , and
      Stopped
      .
  2. To see billing account status details, click the drop-down icon for each job status.
    • This screen reflects the ID, status, and error information.

Cancelling Tag remediation jobs

Only one ingestion Tag remediation job can run at a time. If a new Tag remediation job is required to run, you must cancel the previous job first. To cancel a Tag remediation job, use the following API, POST /api/ecam/v1/enrichmentController/jobs/terminate. You can find this API by clicking the
User
icon in the top-left of the Kyndryl Modern Operations Applications landing page and select
Developer Console
. For the application select
ecam > ecam-orc
.
The user must first set the force flag to
false
with the jobId as part of the payload, for example:
{ jobId: "tenant1:*tenant id**", "force": false }
You must set the force flag to
true
with the jobId as part of the payload, for example:
{ jobId: "tenant1:*tenant id**", "force": true }

Scheduled jobs

Users can initiate and schedule the ingestion by provider directly on CAM . The feature allows users to see consumed cloud resources and gain an accurate understanding of which costs and assets belong to which departments, enabling easy charge-back and reconciliation efforts in hours.
Users can schedule the ingestion jobs for different frequencies (hourly, daily, weekly) directly on the application with the cron job scheduler.
To schedule a job ingestion, follow the steps below:
  1. Click on the
    Settings
    drop-down menu and select
    Scheduled Jobs
    .
  2. A new window will display with the Scheduled Ingestion List, that contains the name of the ingestion, creation date, next run time, your name that initiated the ingestion, recurring and status.
  3. To create a new Scheduled Job
    click
    Add Schedule
    .
    • A new window will pop up. Add a name on the
      Job Name
      bar and select a provider from the drop-down menu on the
      Provider
      bar.
    • Select the frequency of the schedule by entering the Minute, Hour, Day, Month and Week in all the cron fields and then, click
      Schedule
      .
  4. To
    Edit
    ,
    Pause
    or
    Delete
    any scheduled ingestion, click on the action menu on the right side of the Scheduled Ingestion name.
    • Click
      Edit
      to change the frequency, name or provider on any of the scheduled ingestions.
    • Click
      Pause
      to stop an ingestion and
      Start
      to continue.
    • Click
      Delete
      to erase a job ingestion.
Do you have two minutes for a quick survey?
Take Survey