Custom Observability

To begin using observability features, you will need a Cekura account. If you do not have access, please contact [e-mail].

Configure Custom Observability

Follow these steps to set up custom observability for your voice agents:

1. Obtain your API key

   Log in to your Cekura dashboard to retrieve your API key. You can find it in the Settings tab visible on the top right corner. This key is essential for authenticating your requests and accessing observability features.
   
   Home > Settings > API

   
2. Create an agent

   Navigate to the dashboard and create an agent. This agent will be responsible for collecting and sending data to the observability platform.

   
3. Define metrics

   Go to dashboard.cekura.ai and select your agent to start creating metrics. These metrics will help you monitor and analyze the performance of your systems.

   
4. Start pushing logs

   Choose your voice provider below to forward call data to Cekura’s observability suite.

   Connect your Providers

   Custom API

   Python

   import requests
   
   # Send call data to Cekura observability
   url = 'https://api.cekura.ai/observability/v1/observe/'
   headers = {
       'X-CEKURA-API-KEY': '<your_cekura_api_key>',
       'Content-Type': 'application/json'
   }
   data = {
       'agent': '<agent_id_in_cekura>',
       'voice_recording_url': '<url_to_call_recording>',
       'transcript_type': 'custom',
       'transcript_json': [
           {
               'role': 'user',
               'content': 'Hello, I want to book an appointment.',
               'start_time': 0.5,
               'end_time': 2.3
           },
           {
               'role': 'assistant',
               'content': 'Sure, what time works for you?',
               'start_time': 2.5,
               'end_time': 4.1
           }
       ],
       'call_id': '<unique_call_identifier>',
       'call_ended_reason': '<reason_for_call_end>'
   }
   
   response = requests.post(url, headers=headers, json=data)
   

   Vapi

   Code

   Python

   import requests
   
   # Forward VAPI webhook response to Cekura
   url = 'https://api.cekura.ai/observability/v1/observe/'
   headers = {
       'X-CEKURA-API-KEY': '<your_cekura_api_key>',
       'Content-Type': 'application/json'
   }
   data = {
       'agent': '<agent_id_in_cekura>',
       'voice_recording_url': vapi_response["stereoRecordingUrl"],
       'transcript_type': 'vapi',
       'transcript_json': vapi_response["messages"],
       'call_id': vapi_response["id"],
       'call_ended_reason': vapi_response["endedReason"]
   }
   
   response = requests.post(url, headers=headers, json=data)
   

   No Code