Skip to content

Learn · Getting started

Getting started

Send your first event and see your first result in about ten minutes.

Checked against the product on · written for people writing code

You will send your first event and see your first result in about ten minutes. It takes a free developer account and a sandbox key. No card, and no sales call.

What you need

  • An email address.
  • One line about what you are building.
  • A terminal, or any language with an HTTP client.

The ten minutes

  1. Create a free developer account.

    An email and one line about what you are building. Reading the docs never needs an account; sending an event does.

  2. Make a sandbox key under Developer tools.

    A sandbox key runs against test data and bills nothing. Copy the value at once — it appears one time.

  3. Send one event.

    The response carries the event id and how many work areas will weigh it.

    from dmzagent import DMZAgent
    
    cx = DMZAgent(api_key="YOUR_API_KEY")
    cx.emit_event(
        "observation",
        agent_subject_id="pump-12",
        subject_type="sensor",
        payload={"reading": 41.2, "unit": "F"},
    )
  4. Open your organization and find the event.

    It appears under the watched thing you named, within a second or two.

  5. Install a rule pack, or write one label of your own.

    A rule needs a warning label to watch for. The library has published packs; a label of your own works the same way.

  6. Write one rule.

    Name the label, pick an action from the fixed list, and turn it on.

  7. Send the event again and watch the rule fire.

    The action runs, or waits for a person when you marked it sensitive.

  8. Open Records and read the entries.

    Arrival, firing, decision, and outcome are each one entry, hash-linked to the one before.

What just happened

Every event runs the same four steps. It is taken in, weighed against your rule packs, responded to when a rule says so, and written to the logbook. Learn that once and every screen makes sense.

console.dmzagent.com/welcome

Start

Welcome

Three steps to your first result. About ten minutes.
1
1. Connect datanow

Point a feed at the platform, or paste a sample.

2. Pick warning labelsnext

Install a rule pack, or write your own labels.

3. See your first resultnext

Watch the event land and the rule fire.

2Skip for nowConnect data
Figure. The welcome screen walks the same path from inside the console. The welcome screen with three set-up steps and a Connect data button.
Where to go next, by what you are doing.
You want toRead
Learn the words the screens useCore concepts, then the glossary
Connect a real data sourceConnect a data feed
Guard a chatbotPut a guarded chat on your site
Write code against the APIThe API, then errors and pagination
Show an auditor somethingWhat you can prove