# WITSML

To collect WITSML data, the collector can connect to several different data sources simultaneously and act either as a **client**, requesting periodically new data, or as a **server**, receiving data from any third-party client.

{% hint style="info" %}
Currently supported WITSML versions are 1.3.1, 1.4.1 and 2.0.
{% endhint %}

In both modes (server or client), the WITSML capabilities on the LiveRig Collector are limited to the objects listed below. The data ingested by those objects typically will be transmitted to Intelie Live and converted as events for both real-time and historical analytics.

* Version 1.3 and 1.4
  * log (depth and time-based)
  * mudLog
  * message
  * trajectory
  * wbGeometry
  * tubular
* Version 2.0
  * log (depth and time-based)

This support enables the data import into the edge environments (typically in physical rigs with small hardware requirements). 

A more complete feature for WITSML capabilities is also provided through the [WITSML Store plugin](https://drilling.intelie.com/integrations/witsml-store) in a full Intelie Live installation (central or at the edge environments).

### Configuration

Once the [Remote Control](https://drilling.intelie.com/collector/remote-control) feature is enabled, the user can configure a new WITSML source remotely as follows.

#### Client mode

<figure><img src="https://2579444069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lno5CP_Y4IUtBWLlJZl%2Fuploads%2FCVRir5jrB70IgH6OCAQl%2Fcollector-witsml-client-mode.png?alt=media&#x26;token=931f1e2f-83b0-446d-a383-00f22089d8c8" alt=""><figcaption><p>WITSML source in client mode</p></figcaption></figure>

<figure><img src="https://2579444069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lno5CP_Y4IUtBWLlJZl%2Fuploads%2F2RWSuah9EqcTyit7Vynl%2FScreenshot_select-area_20220921095859.png?alt=media&#x26;token=9aaaa955-cbc9-4ab1-8abf-f4241f11670e" alt=""><figcaption><p>Access point to the third-party witsml server to pull data from periodically</p></figcaption></figure>

#### Server mode

<figure><img src="https://2579444069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lno5CP_Y4IUtBWLlJZl%2Fuploads%2Fh7jScfn5kImbZ0ZC9mJp%2Fcollector-witsml-server-mode.png?alt=media&#x26;token=7bf55179-0b8d-48fb-b342-f661d1c4b9bd" alt=""><figcaption><p>WITSML source in server mode</p></figcaption></figure>

The endpoint configuration for server mode will depend on a HTTP port available on the collector machine to listen for connections from third-party clients. Any external client may push data into this endpoint through WITSML using the credentials filled at this form.

<figure><img src="https://2579444069-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Lno5CP_Y4IUtBWLlJZl%2Fuploads%2FwipHyhU1aSpIZ9MyJbZB%2Fcollector-witsml-access-endpoint.png?alt=media&#x26;token=1503df1a-d46f-4088-b991-bca7ca889214" alt=""><figcaption><p>Endpoint to listen for WITSML connections, then third parties may push data into.</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://drilling.intelie.com/collector/protocols/witsml.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.