> For the complete documentation index, see [llms.txt](https://developers.neowit.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.neowit.io/starlark/modules/series-module.md).

# series module

## Introduction

This modules enables publishing metrics towards the Neowit metrics store.

## Example

This example defines and registers a new [devices.Device](/starlark/modules/devices-module.md) and then publishes a temperature sensor metric towards Neowit metrics store.

```python
# defined the device and its attributes
device = devices.Device(
  external_id = id,
  name = "My temperature sensor in room 302",
  vendor = "Contoso Galactic",
  model = "HotHot",
  status = "STATUS_CONNECTED",
  status_reason = "OK"
)
# register or update the attributes of the device
devices.upsert(device)

# publish the new temperature metric
series.publish(device.external_id, time.now().unix, sensors.TEMP, 30.2)
```

## Functions

### def publish(external\_id: str, timestamp: int64, sensor: [SensorType](/starlark/modules/sensors-module.md), value: number = None):

Publishes a new metric value for the device with external\_id that occured on the current time of execution with a sensor type of [sensors.TEMP](/starlark/modules/sensors-module.md)