CircleCI

Gets the details of the CircleCI workflows; including the details of the last runs and the jobs, and retrieves the artifacts of the jobs.

Utilities · CircleCI

Details

IDCircleCI
ProviderCircleCI
CategoryUtilities
From Version5.5.0
Docker Imagedemisto/python3:3.12.13.10116658
Supported ModulesAgentix XSIAM

README

Gets the details of the CircleCI workflows; including the details of the last runs and the jobs, and retrieves the artifacts of the jobs.
This integration was integrated and tested with version v2 of CircleCI.

Configure CircleCI on Cortex XSOAR

  1. Navigate to Settings > Integrations > Servers & Services.
  2. Search for CircleCI.

  3. Click Add Instance to create and configure a new integration instance.

    Parameter Description Required
    Your server URL   True
    API key The API key used to connect True
    Version control system type Type of version control system True
    Organization Name Name of the organization True
    Project Name Name of the project True
    Trust any certificate (not secure)   True
    Use system proxy settings   False
  4. Click Test to validate the URLs, token, and connection.

Commands

You can execute these commands from the Cortex XSOAR CLI, as part of an automation, or in a playbook.
After you successfully execute a command, a DBot message appears in the War Room with the command details.

circleci-workflows-list

Gets information on workflows.

Base Command

circleci-workflows-list

Input

Argument Name Description Required
limit Maximum number of workflows to retrieve. Default is 20. Optional
vcs_type Version control system type of the project. Possible values: “github” and bitbucket”. Default is github. Optional
organization Organization from which to retrieve workflows. Defaults to the organization instance parameter. Optional
project Project from which to retrieve workflows. Defaults to the project instance parameter. Optional

Context Output

Path Type Description
CircleCI.Workflow.metrics.duration_metrics.max Number Maximum workflow run time.
CircleCI.Workflow.metrics.duration_metrics.mean Number Mean workflow run time.
CircleCI.Workflow.metrics.duration_metrics.median Number Median workflow run time.
CircleCI.Workflow.metrics.duration_metrics.min Number Minimum workflow run time.
CircleCI.Workflow.metrics.duration_metrics.p95 Number 95th percentile workflow run time.
CircleCI.Workflow.metrics.duration_metrics.standard_deviation Number The standard deviation of the workflow run time.
CircleCI.Workflow.metrics.duration_metrics.total_duration Number Total duration.
CircleCI.Workflow.metrics.failed_runs Number Number of failed workflow runs.
CircleCI.Workflow.metrics.median_credits_used Number Median credits used.
CircleCI.Workflow.metrics.mttr Number Mean recovery time.
CircleCI.Workflow.metrics.success_rate Number Success rate.
CircleCI.Workflow.metrics.successful_runs Number Number of successful runs.
CircleCI.Workflow.metrics.throughput Number Throughput.
CircleCI.Workflow.metrics.total_credits_used Number Total credits used.
CircleCI.Workflow.metrics.total_recoveries Number Total recoveries.
CircleCI.Workflow.metrics.total_runs Number Total runs.
CircleCI.Workflow.name String Workflow name.
CircleCI.Workflow.project_id String The project ID that the workflow belongs to.
CircleCI.Workflow.window_end Date When the workflow ended.
CircleCI.Workflow.window_start Date When the workflow started.

Command Example

!circleci-workflows-list limit=2

Context Example

{
    "CircleCI": {
        "Workflow": {
            "metrics": {
                "duration_metrics": {
                    "max": 6011,
                    "mean": 4508,
                    "median": 4508,
                    "min": 3005,
                    "p95": 5860,
                    "standard_deviation": 2125,
                    "total_duration": 0
                },
                "failed_runs": 1,
                "median_credits_used": 0,
                "mttr": 0,
                "success_rate": 0.5,
                "successful_runs": 1,
                "throughput": 0.2,
                "total_credits_used": 1900,
                "total_recoveries": 0,
                "total_runs": 2
            },
            "name": "bucket_upload_trigger",
            "project_id": "4eaba5af-8c43-43ec-b469-3968d8a76f68",
            "window_end": "2021-04-22T14:28:57.252Z",
            "window_start": "2021-04-13T12:31:14.409Z"
        }
    }
}

Human Readable Output

CircleCI Workflows

Metrics Name ProjectId WindowEnd WindowStart
total_runs: 181
successful_runs: 136
mttr: 93519
total_credits_used: 323000
failed_runs: 43
median_credits_used: 0
success_rate: 0.7513812154696132
duration_metrics: {“min”: 202, “mean”: 8807, “median”: 8606, “p95”: 11307, “max”: 16317, “standard_deviation”: 1707.0, “total_duration”: 0}
total_recoveries: 0
throughput: 2.033707865168539		 bucket_upload 4eaba5af-8c43-43ec-b469-3968d8a76f68 2021-06-28T23:42:38.647Z 2021-03-31T09:01:11.412Z
total_runs: 2
successful_runs: 1
mttr: 0
total_credits_used: 1900
failed_runs: 1
median_credits_used: 0
success_rate: 0.5
duration_metrics: {“min”: 3005, “mean”: 4508, “median”: 4508, “p95”: 5860, “max”: 6011, “standard_deviation”: 2125.0, “total_duration”: 0}
total_recoveries: 0
throughput: 0.2		 bucket_upload_trigger 4eaba5af-8c43-43ec-b469-3968d8a76f68 2021-04-22T14:28:57.252Z 2021-04-13T12:31:14.409Z

circleci-artifacts-list

Retrieves the artifacts list from the CircleCI job.

Base Command

circleci-artifacts-list

Input

Argument Name Description Required
job_number The number of the job from which to retrieve its artifacts, e.g., 31263. Required
artifact_suffix Returns only the artifacts for which the suffix corresponds to the given suffix, e.g., ‘test_failures.txt’ will only retrieve the artifacts for which the suffix ends with test_failures.txt. Optional
limit Maximum number of artifacts to retrieve. Default is 20. Optional
vcs_type The version control system type of the project. Possible values: “github” and “bitbucket”. Default is github. Optional
organization Organization from which to retrieve artifacts. Defaults to the organization instance parameter. Optional
project Project from which to retrieve artifacts. Defaults to the project instance parameter. Optional

Context Output

Path Type Description
CircleCI.Artifact.path String Artifact relative path.
CircleCI.Artifact.node_index Number Artifact node index.
CircleCI.Artifact.url String Artifact URL.

Command Example

!circleci-artifacts-list job_number=390115 limit=2

Context Example

{
    "CircleCI": {
        "Artifact": [
            {
                "node_index": 0,
                "path": "artifacts/env.json",
                "url": "https://390115-12353212-gh.circle-artifacts.com/0/artifacts/env.json"
            },
            {
                "node_index": 0,
                "path": "artifacts/debug_log.log",
                "url": "https://390115-12353212-gh.circle-artifacts.com/0/artifacts/debug_log.log"
            }
        ]
    }
}

Human Readable Output

CircleCI Artifacts

NodeIndex Path Url
0 artifacts/env.json https://390115-12353212-gh.circle-artifacts.com/0/artifacts/env.json
0 artifacts/debug_log.log https://390115-12353212-gh.circle-artifacts.com/0/artifacts/debug_log.log

circleci-workflow-jobs-list

Retrieves the jobs list from the CircleCI workflow.

Base Command

circleci-workflow-jobs-list

Input

Argument Name Description Required
workflow_id The workflow ID from which to retrieve its jobs, e.g., 12zxcase-12za-as51-123zs4sdgf12. Required
limit The maximum number of jobs to retrieve. Default is 20. Optional

Context Output

Path Type Description
CircleCI.WorkflowJob.id String Job ID.
CircleCI.WorkflowJob.job_number Number Job number.
CircleCI.WorkflowJob.name String Job name.
CircleCI.WorkflowJob.project_slug String Job project slug.
CircleCI.WorkflowJob.started_at Date Time the job started.
CircleCI.WorkflowJob.status String Job status.
CircleCI.WorkflowJob.stopped_at Date Time the job stopped.
CircleCI.WorkflowJob.type String Job type.
CircleCI.WorkflowJob.dependencies String Job dependencies.

Command Example

!circleci-workflow-jobs-list workflow_id=f85efae0-cbf4-4b6d-b136-e3db67d41221 limit=2

Context Example

{
    "CircleCI": {
        "Workflow": {
            "Job": [
                {
                    "dependencies": [],
                    "id": "c7425325-bb57-4e78-968f-2c9867d31z11",
                    "job_number": 389133,
                    "name": "Setup Environment",
                    "project_slug": "gh/organization_name/repo_name",
                    "started_at": "2021-06-24T00:04:57Z",
                    "status": "success",
                    "stopped_at": "2021-06-24T00:06:32Z",
                    "type": "build"
                },
                {
                    "dependencies": [
                        "c7425325-bb57-4e78-968f-2c9867d31z11"
                    ],
                    "id": "89d36e04-5481-48a3-8be4-ddcb2bdcz1q1",
                    "job_number": 389166,
                    "name": "Run Validations",
                    "project_slug": "gh/organization_name/repo_name",
                    "started_at": "2021-06-24T00:06:35Z",
                    "status": "success",
                    "stopped_at": "2021-06-24T00:38:00Z",
                    "type": "build"
                }
            ]
        }
    }
}

Human Readable Output

CircleCI Workflow f85efae0-cbf4-4b6d-b136-e3db67d41221 Jobs

Dependencies Id JobNumber Name ProjectSlug StartedAt Status StoppedAt Type
  c7425325-bb57-4e78-968f-2c9867d31z11 389133 Setup Environment gh/organization_name/repo_name 2021-06-24T00:04:57Z success 2021-06-24T00:06:32Z build
c7425325-bb57-4e78-968f-2c9867d31z11 89d36e04-5481-48a3-8be4-ddcb2bdcz1q1 389166 Run Validations gh/organization_name/repo_name 2021-06-24T00:06:35Z success 2021-06-24T00:38:00Z build

circleci-workflow-last-runs

Retrieves the jobs list from the CircleCI workflow.

Base Command

circleci-workflow-last-runs

Input

Argument Name Description Required
workflow_name Name of the workflow from which to retrieve its last runs details. Required
limit Maximum number of workflow runs to retrieve. Default is 20. Optional
vcs_type Version control system type of the project. Possible values: “github” and “bitbucket”. Default is github. Optional
organization Organization from which to retrieve workflow last runs. Defaults to the organization instance parameter. Optional
project Project from which to retrieve workflow last runs. Defaults to the project instance parameter. Optional

Context Output

Path Type Description
CircleCI.WorkflowRun.branch String Branch name.
CircleCI.WorkflowRun.created_at Date Time run created.
CircleCI.WorkflowRun.credits_used Number Credits used.
CircleCI.WorkflowRun.duration Number Duration of run in seconds.
CircleCI.WorkflowRun.id String ID of the run.
CircleCI.WorkflowRun.status String Run status.
CircleCI.WorkflowRun.stopped_at Date Time run stopped.

Command Example

!circleci-workflow-last-runs workflow_name=nightly limit=2

Context Example

{
    "CircleCI": {
        "WorkflowRun": [
            {
                "branch": "master",
                "created_at": "2021-06-29T00:04:56.069Z",
                "credits_used": 2482,
                "duration": 7743,
                "id": "d832d004-0069-4412-8e6d-41265143411z",
                "status": "failed",
                "stopped_at": "2021-06-29T02:13:59.354Z"
            },
            {
                "branch": "master",
                "created_at": "2021-06-28T00:04:55.409Z",
                "credits_used": 3129,
                "duration": 9778,
                "id": "531e678e-73e3-4f2a-ac80-55aa203461za",
                "status": "failed",
                "stopped_at": "2021-06-28T02:47:52.916Z"
            }
        ]
    }
}

Human Readable Output

CircleCI Workflow nightly Last Runs

Branch CreatedAt CreditsUsed Duration Id Status StoppedAt
master 2021-06-29T00:04:56.069Z 2482 7743 d832d004-0069-4412-8e6d-41265143411z failed 2021-06-29T02:13:59.354Z
master 2021-06-28T00:04:55.409Z 3129 9778 531e678e-73e3-4f2a-ac80-55aa203461za failed 2021-06-28T02:47:52.916Z

circleci-trigger-workflow

Triggers a new pipeline on the project.

Base Command

circleci-trigger-workflow

Input

Argument Name Description Required
parameters A JSON object containing pipeline parameters and their values. Required

Context Output

Path Type Description
CircleCI.WorkflowTrigger.id number The workflow ID.
CircleCI.WorkflowTrigger.created_at number Date when the workflow was created.
CircleCI.WorkflowTrigger.number number The workflow number.
CircleCI.WorkflowTrigger.state number The workflow state.

Command Example

!circleci-trigger-workflow parameters={"param1": "value"}

Context Example

{
    "CircleCI": {
        "WorkflowTrigger": {
            "created_at": "2021-07-28T15:49:33.906Z",
            "id": "9bc69b28-f241-4918",
            "number": 103232,
            "state": "pending"
        }
    }
}

Human Readable Output

CircleCI Workflow created successfully, ID=103232

Configuration parameters

  • url — Your server URL (required)
  • api_key — The API key
  • api_key_creds —
  • vcs_type — Version control system type (required)
  • organization — Organization name (required)
  • project — Project Name (required)
  • insecure — Trust any certificate (not secure)
  • proxy — Use system proxy settings

Commands (5)

  • circleci-artifacts-list

    Retrieves the artifacts list from the CircleCI job.

  • circleci-trigger-workflow

    Triggers a new pipeline on the project.

  • circleci-workflow-jobs-list

    Retrieves the jobs list from the CircleCI workflow.

  • circleci-workflow-last-runs

    Retrieves the jobs list from the CircleCI workflow.

  • circleci-workflows-list

    Gets information on workflows.

Source

CircleCI.py CircleCI_test.py CircleCI.yml CircleCI_description.md command_examples.txt
Download History Raw 
category: Utilities
provider: CircleCI
commonfields:
  id: CircleCI
  version: -1
configuration:
- defaultvalue: https://circleci.com
  display: Your server URL
  name: url
  required: true
  type: 0
- display: The API key
  additionalinfo: The API Key to use for connection. Required for private repositories.
  name: api_key
  type: 4
  hidden: true
  required: false
- name: api_key_creds
  type: 9
  displaypassword: The API key
  hiddenusername: true
  required: false
- display: Version control system type
  name: vcs_type
  type: 15
  required: true
  additionalinfo: Type of version control system
  options:
  - github
  - bitbucket
- display: Organization name
  name: organization
  type: 0
  required: true
  additionalinfo: Name of the organization
- display: Project Name
  name: project
  required: true
  type: 0
  additionalinfo: Name of the project
- display: Trust any certificate (not secure)
  name: insecure
  type: 8
  required: false
- display: Use system proxy settings
  name: proxy
  type: 8

  required: false
description: Gets the details of the CircleCI workflows; including the details of the last runs and the jobs, and retrieves the artifacts of the jobs.
display: CircleCI
name: CircleCI
script:
  commands:
  - arguments:
    - description: The maximum number of workflows to retrieve.
      defaultValue: '20'
      name: limit
    - name: vcs_type
      description: 'The version control system type of the project. Possible values: "github" and "bitbucket".'
      default: true
      auto: PREDEFINED
      predefined:
      - github
      - bitbucket
      defaultValue: github
    - description: The organization from which to retrieve workflows. Defaults to the organization instance parameter.
      name: organization
    - description: The project from which to retrieve workflows. Defaults to the project instance parameter.
      name: project
    description: Gets information on workflows.
    name: circleci-workflows-list
    outputs:
    - contextPath: CircleCI.Workflow.metrics.duration_metrics.max
      description: Maximum workflow run time.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.duration_metrics.mean
      description: Mean workflow run time.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.duration_metrics.median
      description: Median workflow run time.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.duration_metrics.min
      description: Minimum workflow run time.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.duration_metrics.p95
      description: The 95th percentile workflow run time.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.duration_metrics.standard_deviation
      description: The standard deviation of the workflow run time.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.duration_metrics.total_duration
      description: Total duration.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.failed_runs
      description: Number of failed workflow runs.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.median_credits_used
      description: Median credits used.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.mttr
      description: Mean recovery time.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.success_rate
      description: Success rate.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.successful_runs
      description: Number of successful runs.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.throughput
      description: Throughput.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.total_credits_used
      description: Total credits used.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.total_recoveries
      description: Total recoveries.
      type: Number
    - contextPath: CircleCI.Workflow.metrics.total_runs
      description: Total runs.
      type: Number
    - contextPath: CircleCI.Workflow.name
      description: Workflow name.
      type: String
    - contextPath: CircleCI.Workflow.project_id
      description: The project ID that the workflow belongs to.
      type: String
    - contextPath: CircleCI.Workflow.window_end
      description: When the workflow ended.
      type: Date
    - contextPath: CircleCI.Workflow.window_start
      description: When the workflow started.
      type: Date
  - arguments:
    - description: The number of the job used to retrieve its artifacts, e.g., 31263.
      name: job_number
      required: true
    - description: Returns only the artifacts for which the suffix corresponds to the given suffix, e.g., 'test_failures.txt' will only retrieve artifacts for which the suffix ends with test_failures.txt.
      name: artifact_suffix
    - description: The maximum number of artifacts to retrieve.
      defaultValue: '20'
      name: limit
    - name: vcs_type
      description: 'The version control system type of the project. Possible values: "github" and "bitbucket".'
      default: true
      auto: PREDEFINED
      predefined:
      - github
      - bitbucket
      defaultValue: github
    - description: The organization from which to retrieve artifacts. Defaults to the organization instance parameter.
      name: organization
    - description: The project from which to retrieve artifacts. Defaults to the project instance parameter.
      name: project
    description: Retrieves the artifacts list from the CircleCI job.
    name: circleci-artifacts-list
    outputs:
    - contextPath: CircleCI.Artifact.path
      description: Artifact relative path.
      type: String
    - contextPath: CircleCI.Artifact.node_index
      description: Artifact node index.
      type: Number
    - contextPath: CircleCI.Artifact.url
      description: Artifact URL.
      type: String
  - arguments:
    - description: The workflow ID from which to retrieve its jobs, e.g., 12zxcase-12za-as51-123zs4sdgf12.
      name: workflow_id
      required: true
    - description: The maximum number of jobs to retrieve.
      defaultValue: '20'
      name: limit
    description: Retrieves the jobs list from the CircleCI workflow.
    name: circleci-workflow-jobs-list
    outputs:
    - contextPath: CircleCI.WorkflowJob.id
      description: Job ID.
      type: String
    - contextPath: CircleCI.WorkflowJob.job_number
      description: Job number.
      type: Number
    - contextPath: CircleCI.WorkflowJob.name
      description: Job name.
      type: String
    - contextPath: CircleCI.WorkflowJob.project_slug
      description: Job project slug.
      type: String
    - contextPath: CircleCI.WorkflowJob.started_at
      description: Time the job started.
      type: Date
    - contextPath: CircleCI.WorkflowJob.status
      description: Job status.
      type: String
    - contextPath: CircleCI.WorkflowJob.stopped_at
      description: Time the job stopped.
      type: Date
    - contextPath: CircleCI.WorkflowJob.type
      description: Job type.
      type: String
    - contextPath: CircleCI.WorkflowJob.dependencies
      description: Job dependencies.
      type: String
  - arguments:
    - description: Name of the workflow from which to retrieve its last runs details.
      name: workflow_name
      required: true
    - description: The maximum number of workflow runs to retrieve.
      defaultValue: '20'
      name: limit
    - name: vcs_type
      description: 'The version control system type of the project. Possible values: "github" and "bitbucket".'
      default: true
      auto: PREDEFINED
      predefined:
      - github
      - bitbucket
      defaultValue: github
    - description: Organization from which to retrieve workflow last runs. Defaults to the organization instance parameter.
      name: organization
    - description: Project from which to retrieve workflow last runs. Defaults to the project instance parameter.
      name: project
    - description: Name of the branch.
      name: branch
    description: Retrieves the jobs list from the CircleCI workflow.
    name: circleci-workflow-last-runs
    outputs:
    - contextPath: CircleCI.WorkflowRun.branch
      description: Branch name.
      type: String
    - contextPath: CircleCI.WorkflowRun.created_at
      description: Time the run was created.
      type: Date
    - contextPath: CircleCI.WorkflowRun.credits_used
      description: Credits used.
      type: Number
    - contextPath: CircleCI.WorkflowRun.duration
      description: Duration of the run in seconds.
      type: Number
    - contextPath: CircleCI.WorkflowRun.id
      description: ID of the run.
      type: String
    - contextPath: CircleCI.WorkflowRun.status
      description: Run status.
      type: String
    - contextPath: CircleCI.WorkflowRun.stopped_at
      description: Time the run stopped.
      type: Date
  - arguments:
    - description: A JSON object containing pipeline parameters and their values.
      name: parameters
      required: true
    description: Triggers a new pipeline on the project.
    name: circleci-trigger-workflow
    outputs:
    - contextPath: CircleCI.WorkflowTrigger.id
      description: The workflow ID.
      type: number
    - contextPath: CircleCI.WorkflowTrigger.created_at
      description: Date when the workflow was created.
      type: number
    - contextPath: CircleCI.WorkflowTrigger.number
      description: The workflow number.
      type: number
    - contextPath: CircleCI.WorkflowTrigger.state
      description: The workflow state.
      type: number
  runonce: false
  script: '-'
  type: python
  subtype: python3
  dockerimage: demisto/python3:3.12.13.10116658
fromversion: 5.5.0
tests:
- No tests (auto formatted)