Wysyłanie zdarzeń do środowiska usługi Azure Time Series Insights Gen1 przy użyciu centrum zdarzeń

  • Artykuł

Uwaga

Usługa Time Series Insights (TSI) nie będzie już obsługiwana po marcu 2025 r. Rozważ migrację istniejących środowisk TSI do alternatywnych rozwiązań tak szybko, jak to możliwe. Aby uzyskać więcej informacji na temat wycofywania i migracji, odwiedź naszą dokumentację.

Przestroga

Jest to artykuł z generacji 1.

W tym artykule wyjaśniono, jak utworzyć i skonfigurować centrum zdarzeń w Azure Event Hubs. Opisano w nim również sposób uruchamiania przykładowej aplikacji w celu wypychania zdarzeń do Azure Time Series Insights z usługi Event Hubs. Jeśli masz istniejące centrum zdarzeń ze zdarzeniami w formacie JSON, pomiń ten samouczek i wyświetl środowisko w Azure Time Series Insights.

Konfigurowanie centrum zdarzeń

  1. Aby dowiedzieć się, jak utworzyć centrum zdarzeń, przeczytaj dokumentację usługi Event Hubs.

  2. W polu wyszukiwania wyszukaj usługę Event Hubs. Na zwróconej liście wybierz pozycję Event Hubs.

  3. Wybierz centrum zdarzeń.

  4. Podczas tworzenia centrum zdarzeń tworzysz przestrzeń nazw centrum zdarzeń. Jeśli centrum zdarzeń nie zostało jeszcze utworzone w przestrzeni nazw, w menu w obszarze Jednostki utwórz centrum zdarzeń.

    Lista centrów zdarzeń

  5. Po utworzeniu centrum zdarzeń wybierz je na liście centrów zdarzeń.

  6. W menu w obszarze Jednostki wybierz pozycję Event Hubs.

  7. Wybierz nazwę centrum zdarzeń, aby je skonfigurować.

  8. W obszarze Przegląd wybierz pozycję Grupy odbiorców, a następnie wybierz pozycję Grupa konsumentów.

    Tworzenie grupy odbiorców

  9. Upewnij się, że utworzono grupę odbiorców używaną wyłącznie przez źródło zdarzeń Azure Time Series Insights.

    Ważne

    Upewnij się, że ta grupa odbiorców nie jest używana przez żadną inną usługę, taką jak zadanie usługi Azure Stream Analytics lub inne środowisko Azure Time Series Insights. Jeśli grupa odbiorców jest używana przez inne usługi, operacje odczytu mają negatywny wpływ zarówno na to środowisko, jak i na inne usługi. Jeśli używasz $Default jako grupy odbiorców, inni czytelnicy mogą potencjalnie ponownie użyć grupy odbiorców.

  10. W menu w obszarze Ustawienia wybierz pozycję Zasady dostępu współdzielonego, a następnie wybierz pozycję Dodaj.

    Wybierz pozycję Zasady dostępu współdzielonego, a następnie wybierz przycisk Dodaj

  11. W okienku Dodawanie nowych zasad dostępu współdzielonego utwórz dostęp udostępniony o nazwie MySendPolicy. Te zasady dostępu współdzielonego służą do wysyłania zdarzeń w przykładach języka C# w dalszej części tego artykułu.

    W polu Nazwa zasad wprowadź mySendPolicy

  12. W obszarze Oświadczenie zaznacz pole wyboru Wyślij .

Dodawanie wystąpienia Azure Time Series Insights

W Azure Time Series Insights Gen2 można dodać dane kontekstowe do przychodzących danych telemetrycznych przy użyciu modelu szeregów czasowych (TSM). W programie TSM tagi lub sygnały są określane jako wystąpienia i można przechowywać dane kontekstowe w polach wystąpień. Dane są łączone w czasie wykonywania zapytania przy użyciu identyfikatora szeregów czasowych. Identyfikator szeregu czasowego dla przykładowego projektu wiatraków, którego używamy w dalszej części tego artykułu, to id. Aby dowiedzieć się więcej na temat przechowywania danych w polach wystąpień, zapoznaj się z omówieniem modelu szeregów czasowych .

Tworzenie źródła zdarzeń Azure Time Series Insights

  1. Jeśli nie utworzono źródła zdarzeń, wykonaj kroki tworzenia źródła zdarzeń.

  2. Ustaw wartość parametru timeSeriesId. Aby dowiedzieć się więcej na temat identyfikatora szeregów czasowych, przeczytaj Modele szeregów czasowych.

Wypychanie zdarzeń do przykładu wiatraków

  1. Na pasku wyszukiwania wyszukaj usługę Event Hubs. Na zwróconej liście wybierz pozycję Event Hubs.

  2. Wybierz wystąpienie centrum zdarzeń.

  3. Przejdź do pozycji Zasady> dostępu współdzielonegoMySendPolicy. Skopiuj wartość parametrów połączenia — klucz podstawowy.

    Skopiuj wartość parametrów połączenia klucza podstawowego

  4. Przejdź do wypychacza przykładowej farmy wiatrowej usługi TSI. Lokacja tworzy i uruchamia symulowane urządzenia wiatrowe.

  5. W polu Parametry połączenia centrum zdarzeń na stronie internetowej wklej parametry połączenia skopiowane w polu wejściowym wiatraka.

    Wklej parametry połączenia klucza podstawowego w polu Parametry połączenia centrum zdarzeń

  6. Wybierz pozycję Kliknij, aby rozpocząć.

    Porada

    Symulator wiatraka tworzy również kod JSON, którego można użyć jako ładunku z interfejsami API zapytań ga Azure Time Series Insights.

    Uwaga

    Symulator będzie nadal wysyłać dane do momentu zamknięcia karty przeglądarki.

  7. Wstecz do centrum zdarzeń w Azure Portal. Na stronie Przegląd są wyświetlane nowe zdarzenia odebrane przez centrum zdarzeń.

    Strona Przegląd centrum zdarzeń przedstawiająca metryki centrum zdarzeń

Obsługiwane kształty JSON

Przykład jeden

  • Dane wejściowe: prosty obiekt JSON.

    {
    "id":"device1",
    "timestamp":"2016-01-08T01:08:00Z"
}

  • Dane wyjściowe: jedno zdarzenie.

    identyfikator sygnatura czasowa
    device1 2016-01-08T01:08:00Z

Przykład dwa

  • Dane wejściowe: tablica JSON z dwoma obiektami JSON. Każdy obiekt JSON jest konwertowany na zdarzenie.

    [
    {
        "id":"device1",
        "timestamp":"2016-01-08T01:08:00Z"
    },
    {
        "id":"device2",
        "timestamp":"2016-01-17T01:17:00Z"
    }
]

  • Dane wyjściowe: dwa zdarzenia.

    identyfikator sygnatura czasowa
    device1 2016-01-08T01:08:00Z
    device2 2016-01-08T01:17:00Z

Przykład trzy

  • Dane wejściowe: obiekt JSON z zagnieżdżonym tablicą JSON zawierającą dwa obiekty JSON.

    {
    "location":"WestUs",
    "events":[
        {
            "id":"device1",
            "timestamp":"2016-01-08T01:08:00Z"
        },
        {
            "id":"device2",
            "timestamp":"2016-01-17T01:17:00Z"
        }
    ]
}

  • Dane wyjściowe: dwa zdarzenia. Lokalizacja właściwości jest kopiowana do każdego zdarzenia.

    location events.id events.timestamp
    WestUs device1 2016-01-08T01:08:00Z
    WestUs device2 2016-01-08T01:17:00Z

Przykład cztery

  • Dane wejściowe: obiekt JSON z zagnieżdżonym tablicą JSON zawierającą dwa obiekty JSON. Te dane wejściowe pokazują, że właściwości globalne mogą być reprezentowane przez złożony obiekt JSON.

    {
    "location":"WestUs",
    "manufacturer":{
        "name":"manufacturer1",
        "location":"EastUs"
    },
    "events":[
        {
            "id":"device1",
            "timestamp":"2016-01-08T01:08:00Z",
            "data":{
                "type":"pressure",
                "units":"psi",
                "value":108.09
            }
        },
        {
            "id":"device2",
            "timestamp":"2016-01-17T01:17:00Z",
            "data":{
                "type":"vibration",
                "units":"abs G",
                "value":217.09
            }
        }
    ]
}

  • Dane wyjściowe: dwa zdarzenia.

    location manufacturer.name manufacturer.location events.id events.timestamp events.data.type events.data.units events.data.value
    WestUs manufacturer1 EastUs device1 2016-01-08T01:08:00Z ciśnienie psi 108.09
    WestUs manufacturer1 EastUs device2 2016-01-08T01:17:00Z vibration abs G 217.09

Następne kroki