See what happens inside a run.
A small SDK connects runtime errors, service costs, and admission rules to your ActorConsole workspace.
Connect an Actor
- Generate a key for the imported Actor in SDK setup. Each key can report only to that Actor.
- Download the SDK file into your Actor source. Add
ACTORCONSOLE_KEYas a secret environment variable in Apify Console. Keep it out of Actor input, source code, and logs. - Wrap your existing work with the example below, then deploy the Actor through your usual workflow. Capture a test error and check Monitoring.
JavaScript · Node.js 20+
Download SDKimport { Actor } from 'apify';
import { withActorConsole } from './actorconsole.mjs';
await Actor.init();
await withActorConsole(async (console) => {
// Put your existing Actor work here.
// Report paid services using a stable transaction ID:
// await console.trackCost('AI API', 0.012, { eventId: 'provider-txn-id' });
});
await Actor.exit();Python · 3.10+
Download SDKfrom apify import Actor
from actorconsole import ActorConsole
async def main():
async with Actor:
async with ActorConsole() as console:
# Put your existing Actor work here.
# await console.track_cost('AI API', 0.012, event_id='provider-txn-id')
passHow reporting and run rules work
Error and expense reports are best effort: a reporting outage leaves Actor work running. Run admission is checked before work starts and fails closed if the service is unavailable. Rules apply only after you integrate the SDK. Local development bypasses admission checks; paying users are exempt.
The SDK reads the run ID, initiating user, and paid status from Apify environment variables. Never override these values using Actor input. Memory samples cover the reporting process and exclude child processes. Input is not collected automatically; include only debugging context you need. Common credential fields are redacted, but custom context still needs care.
Run samples and error events are retained for 90 days. Grouped issue totals and expense records remain until their Actor or account is deleted. Admission records last 100 days; lifetime counters persist for lifetime limits.
Apify environment variable reference