Span Payload
Use this method to store payloads that are 2,000 bytes (2KB) or greater. If your payload is consistently under this threshold, then please use the Data method.
The Logware API will be considered EOL (End of Life) on January 1, 2024. Support for the API and its methods will discontinue on that date. So that you know- Logware customers will be contacted in advance with migration instructions.
StoreSpan
POST
https://api.logware.io/api/span
Post the Span value you wish to store, get a response with a Task Id. Use the Get method with the Task Id to get the Transaction Id. The Task Id can be discarded. The Transaction Id is permanent. Store the Transaction Id for future lookup of the Span value stored.
Headers
Name | Type | Description |
---|---|---|
token | string | Authentication Bearer Token |
Request Body
Name | Type | Description |
---|---|---|
env | string | Target environment [ prod | test ] |
span | string | The Span string to store |
The Task Id included in the StoreSpan method response is temporary and does not need to be saved long term. Use the Task Id to get the Transaction Id with the StoreSpanId method below. The Transaction Id is permanent and must be saved if you intend to look up the data value stored later in the future. After 1 hour, the Task Id is expunged and no longer accessible.
StoreSpanId
GET
https://api.logware.io/api/span/[env]/[taskid]
The Transaction Id will be available within 5 seconds of the StoreSpan POST method response. Use this method to get the permanent Transaction Id of the stored Span value. Your application has 1 hour to get the Transaction Id. After 1 hour passes, the Task Id gets expunged. If you miss the 1 hour expiry, you will need to store another record to get a new Transaction Id.
Query Parameters
Name | Type | Description |
---|---|---|
env | string | Target environment [ prod | test ] |
taskid | string | The value provided in the StoreSpan POST response |
Headers
Name | Type | Description |
---|---|---|
token | string | Authentication Bearer Token |
Last updated