INTEGRITY Dokumentace

Nahrazení stávajících serverů TURN

Pokud jste stávajícím poskytovatelem TURN a chcete svým zákazníkům začít nabízet Cloudflare Realtime TURN, je třeba zvážit několik věcí.

Přínosy

Služba Cloudflare Realtime TURN dokáže snížit hmatatelné i nehmatatelné náklady spojené s TURN servery:

Doporučení

Oddělení prostředí pomocí klíčů TURN

Při rozsáhlejším používání služby Cloudflare Realtime TURN zvažte oddělení prostředí, jako jsou „testing“, „staging“ nebo „production“, pomocí klíčů TURN. Ve svém účtu můžete vytvořit až 1,000 klíčů TURN, které lze použít k generování přihlašovacích údajů pro koncové uživatele.

Počet přihlašovacích údajů koncových uživatelů, které lze vytvořit pomocí konkrétního klíče TURN, není nijak omezen.

Označte uživatele vlastními identifikátory

Služba Cloudflare Realtime TURN umožňuje při generování přihlašovacích údajů označit každý z nich vlastním identifikátorem, například takto:

curl https://rtc.live.cloudflare.com/v1/turn/keys/$TURN_KEY_ID/credentials/generate \
--header "Authorization: Bearer $TURN_KEY_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{"ttl": 864000, "customIdentifier": "user4523958"}'

Toto pole použijte k agregaci využití pro konkrétního uživatele nebo skupinu uživatelů a ke sběru analytických dat.

Sledovat využití

Využití napříč celým účtem můžete sledovat pomocí GraphQL Analytics API. To se hodí pro sledování celkového využití pro fakturační účely a pro odhalování neočekávaných změn. Časové řady dat můžete získat z analytiky TURN s různě nastavenými filtry.

Sledování zneužití přihlašovacích údajů

Pokud přihlašovací údaje TURN sdílíte s koncovými uživateli, hrozí riziko jejich zneužití. Zneužití můžete sledovat tak, že každé přihlašovací údaje označíte vlastními identifikátory a v aplikaci pak sledujete nejvytíženější vlastní identifikátory pomocí GraphQL Analytics API.

Jak fakturovat koncovým uživatelům využití TURN

Při fakturaci využití TURN ve vaší aplikaci je důležité rozumět adaptivnímu vzorkování v analytice TURN a počítat s ním. Tento systém využívá adaptivní vzorkování, aby efektivně zvládal velké datové sady při zachování přesnosti.

Proces vzorkování v analytice TURN probíhá na dvou úrovních:

Pro přesnou fakturaci napište jediný dotaz, který sečte využití TURN pro každého zákazníka za dané období a vrátí jedinou hodnotu. Nepoužívejte dotazy, které vypisují využití více zákazníků najednou.

Pokud budete dodržovat tyto pokyny a porozumíte tomu, jak TURN analytics zpracovává vzorkování, můžete zajistit přesnější fakturaci pro své koncové uživatele na základě jejich využití TURN.

Ukázkové dotazy

query{
  viewer {
    usage: accounts(filter: { accountTag: "8846293bd06d1af8c106d89ec1454fe6" }) {
        callsTurnUsageAdaptiveGroups(
          filter: {
          datetimeMinute_gt: "2024-07-15T02:07:07Z"
          datetimeMinute_lt: "2024-08-10T02:07:05Z"
        }
          limit: 100
          orderBy: [customIdentifier_ASC]
        ) {
          dimensions {
            customIdentifier
          }
          sum {
            egressBytes
          }
        }
      }
    }
  }

Níže je dotaz, který zobrazuje využití pouze pro jednoho zákazníka.

query{
  viewer {
    usage: accounts(filter: { accountTag: "8846293bd06d1af8c106d89ec1454fe6" }) {
        callsTurnUsageAdaptiveGroups(
          filter: {
          datetimeMinute_gt: "2024-07-15T02:07:07Z"
          datetimeMinute_lt: "2024-08-10T02:07:05Z"
          customIdentifier: "myCustomer1111"
        }
          limit: 1
          orderBy: [customIdentifier_ASC]
        ) {
          dimensions {
            customIdentifier
          }
          sum {
            egressBytes
          }
        }
      }
    }
  }