Add current state of sub pages

Author: cleptric

develop-docs/sdk/telemetry/spans/index.mdx

@@ -3,11 +3,4 @@ title: Spans
 sidebar_order: 8
 ---
 
-This section covers how SDKs should implement a spans-only API to support Sentry's tracing product.
-
-Span API
-Span Properties
-Span Sampling
-Span Protocol
-
-Scopes
+<PageGrid />

develop-docs/sdk/telemetry/spans/span-api.mdx

@@ -2,6 +2,182 @@
 title: Span API
 ---
 
+# Span API
 
+### `startSpan`
 
+Calling the global `startSpan` method always creates a root span.
 
+```jsx
+span = sentry.tracing.startSpan({
+	name: 'GET /',
+	op: 'http.server'
+})
+```
+
+```jsx
+span = sentry().tracing().startSpan()
+	->setName('GET /')
+	->setOp('http.server')
+```
+
+### `end`
+
+This method sets the end timestamp on the span. If the span is a root span, it emits the entire span tree to Sentry.
+
+```jsx
+span = sentry.tracing.startSpan({
+	name: 'GET /',
+	op: 'http.server'
+})
+
+span.end()
+```
+
+```jsx
+span = sentry().tracing().startSpan()
+	->setName('GET /')
+	->setOp('http.server')
+	
+span.end()
+```
+
+### `continueTraceFrom`
+
+Creates a new root span which continues the trace based on the provided trace and parent span id.
+
+```jsx
+span = sentry.tracing.startSpan({
+	traceId: '',
+	parentSpanId: '',
+	sampled: true,
+	name: 'GET /'
+	op: 'http.server'
+})
+```
+
+```jsx
+span = sentry.tracing.startSpan({
+	continueTraceFrom: span,
+	name: 'GET /'
+	op: 'http.server'
+})
+```
+
+```jsx
+span = sentry().tracing().continueTraceFrom({
+		traceId: '',
+		parentSpanId: '',
+		sampled: true,
+	})
+	->setName('GET /')
+	->setOp('http.server')
+```
+
+```jsx
+span = sentry().tracing().continueTraceFrom(span)
+	->setName('GET /')
+	->setOp('http.server')
+```
+
+### Start a new root span
+
+Calling the global `startSpan` method always creates a root span.
+
+```jsx
+span = sentry.tracing.startSpan({
+	name: 'GET /',
+	op: 'http.server',
+})
+```
+
+```jsx
+span = sentry().tracing().startSpan()
+	->setName('GET /')
+	->setOp('http.server')
+```
+
+### `setAttribute`
+
+```jsx
+span = sentry.tracing.startSpan({
+	name: 'GET /',
+	op: 'http.server',
+  attributes: {
+	  attr1: "value1",
+    attr2: 42,
+    attr3: true,
+  },
+})
+```
+
+```jsx
+span = sentry().tracing().startSpan()
+	->setName('GET /')
+	->setOp('http.server')
+	->setAtttribute(
+		key: 'attr1',
+		value: 'value1',
+	)
+```
+
+### Starting a child span
+
+To create nested spans, you must call `startSpan` on the parent span.
+
+```jsx
+span = sentry.tracing.startSpan({ ... })
+childSpan = span.startSpan({ ... })
+```
+
+```jsx
+span = sentry().tracing().startSpan()
+childSpan = span.startSpan()
+```
+
+### Get the current span
+
+```jsx
+span = scope.getSpan()
+```
+
+### Set the current span
+
+```jsx
+scope.setSpan(span)
+```
+
+### Get the root span
+
+```jsx
+rootSpan = scope.getRootSpan()
+```
+
+### Additional APIs
+
+span.`setStartTimestamp()` - overwrite the span’s start time
+
+span.`setEndTimestamp()` - overwrites the span’s end time
+
+span.`setStatus()` - success, error, unknown
+
+span.`getBaggage()` - returns the baggage string
+
+span.`getTraceparent()` - returns the sentry trace parent string
+
+### Examples
+
+```jsx
+rootSpan = sentry.tracing.startSpan({
+	name: 'GET /',
+	op: 'http.server',
+})
+
+span = rootSpan.startSpan({
+	name: 'middleware.handle',
+	op: 'http.middleware',
+})
+
+span.end()
+rootSpan.end()
+```

develop-docs/sdk/telemetry/spans/span-properties.mdx

@@ -2,6 +2,14 @@
 title: Span Propertires
 ---
 
+# Span Propertires
 
+Instead of spans containing tags, context, and data, we'll unify all these properties into a new “attributes” property.
+Similar to OTel's semantic conventions, we'll add special meaning to certain attribute keys, such as `sentry.release`, `sentry.op`, etc.
 
+```js
+span.setAttribute('http.request.method', 'GET')
+span.setAttribute('user.email', '[email protected]')
+```
 
+We'll map these attributes to their respective existing property in Relay to ease the work required for the product during the transition period.

develop-docs/sdk/telemetry/spans/span-protocol.mdx

@@ -2,6 +2,62 @@
 title: Span Protocol
 ---
 
+# Span protocol
 
+We'll introduce a new “span” envelope item, which the SDK uses to emit a segment span and its children. And in the future, a batch of spans.
+The payload of each envelope item follows the [OpenTelemetry Protocol](https://opentelemetry.io/docs/specs/otel/protocol/), which introduced typed attributes and will ease the conversion in our POtel SDKs.
 
-
+```json
+{
+	"event_id":"9ec79c33ec9942ab8353589fcb2e04dc"
+}
+{
+	"type": "span"
+}
+{
+	"traceId": "32d3c7cb501fbddbe3ce1016a72d50b5",
+  "spanId": "e91d37480970523b",
+  "name": "GET /",
+  "startTime": "1544712660",
+  "endTime": "1544712680",
+  "attributes": [
+	  {
+			"key": "sentry.op",
+	      "value": {
+	        "stringValue": "http.sever",
+	      }
+		},
+    {
+	    "key": "http.response.status_code",
+      "value": {
+	      "intValue": "200",
+	    }
+	  }
+	}
+}
+{
+	"type": "span"
+}
+{
+	"traceId": "32d3c7cb501fbddbe3ce1016a72d50b5",
+  "spanId": "6b22b3af586e777a",
+  "parentSpanId": "e91d37480970523b",
+  "name": "UserMiddleware",
+  "startTimeUnix": "1544712665",
+  "endTimeUnix": "1544712675",
+  "attributes": [
+	  {
+	    "key": "sentry.op",
+      "value": {
+	      "stringValue": "middleware.handle",
+	    }
+	  },
+	  {
+	    "key": "user.email",
+      "value": {
+	      "stringValue": "[email protected]",
+	    }
+	  }
+	}
+}
+```