Logging and ingestion

Cloud logs can be sent with Python SDK, Node.js SDK, or direct HTTP. Use ALERT for high-priority incidents. Disable SDK cloud forwarding with ALSHIVAL_CLOUD_LEVEL=NONE. Use the DevTools Resource Details page’s Resource URL as ALSHIVAL_RESOURCE for targeting. This supports both owned and shared resources. Supported cloud forwarding levels: DEBUG, INFO, WARNING, ERROR, ALERT, NONE.

Payload format

{
  "logs": [
    {
      "level": "alert",
      "message": "payment queue backed up",
      "ts": "2026-02-22T00:00:00+00:00",
      "extra": {
        "queue": "payments",
        "depth": 921,
        "region": "us-central"
      }
    }
  ]
}

SDK examples

Python
Node.js

import alshival

alshival.configure(
    username='your_username',
    api_key='your_api_key',
    resource='https://alshival.dev/u/resource_owner_username/resources/resource_uuid/',
    cloud_level='INFO',
)

alshival.log.info('worker online')
alshival.log.alert('cpu sustained above 95%', extra={'host': 'worker-2'})

const alshival = require('@alshival.ai/alshival');

alshival.configure({
  username: 'your_username',
  apiKey: 'your_api_key',
  resource: 'https://alshival.dev/u/resource_owner_username/resources/resource_uuid/',
  cloudLevel: 'INFO',
});

alshival.log.info('worker online');
alshival.log.alert('cpu sustained above 95%', { extra: { host: 'worker-2' } });

Common error codes

400 invalid_json: malformed JSON payload
400 invalid_resource: username/resource mismatch
401 invalid_credentials: invalid or revoked key
403 forbidden: authenticated but not authorized

Get started

SDKs

Platform

Help

Logging and ingestion

Payload format

SDK examples

Common error codes

​Payload format

​SDK examples

​Common error codes

Payload format

SDK examples

Common error codes