Blacksmith
Connect
Connect Blacksmith from the terminal. Pass --help for the flags Blacksmith accepts.
polylane integration connect --type blacksmithAn organization token that an organization admin creates with `blacksmith org-token create`, and the GitHub organization login whose jobs run on Blacksmith.
Connect your Blacksmith organization with an organization token and the GitHub organization that runs its jobs on Blacksmith.
- An organization admin installs the Blacksmith CLI with
curl -fsSL https://get.blacksmith.sh | shand runsblacksmith org-token create --label polylane. Blacksmith confirms admin access in the browser and prints the token once. - Paste the token into Polylane and enter the GitHub organization login whose jobs run on Blacksmith. Polylane checks that the token can read that organization.
Polylane only reads from Blacksmith: job runs, job logs, steps, tests, metrics, log search, usage and analytics.
Polylane watches job failure rates, job durations and error log lines across the organization.
Blacksmith organization tokens have no scopes. Their access follows the organization in GitHub, and a token reads jobs, logs, usage and analytics across the whole organization. Polylane only reads from Blacksmith. These are the Blacksmith APIs Polylane uses:
| Tool | Blacksmith API | What it unlocks |
|---|---|---|
blacksmithJobs | Jobs, with their steps, tests, metrics and containers | Finds failed, slow and running jobs and reads the step, test and CPU and memory data of one job. |
blacksmithJobLogs | Job logs | Reads the log lines of one job. |
blacksmithLogs | Log search and log histogram | Searches the logs of every job in the organization and counts matches over time. |
blacksmithAnalytics | Job aggregates and Actions usage | Reads job durations, CPU and memory use, and billable minutes. |
An organization token can also manage testboxes, caches and sticky disks. Polylane uses only the read APIs in this table.
Disconnecting leaves the organization token in Blacksmith. Revoke it with blacksmith org-token revoke <id>.
Disconnect
Disconnecting stops every sync and check and deletes the credentials Polylane held. Polylane removes what Blacksmith's API lets it remove. The following stays until you remove it yourself:
- Blacksmith organization token
polylane integration disconnect <id>Tools
4Operations agents can perform in threads.