Gå til innhold
Vercel

Vercel

Vis som Markdown

Legg til Status200 i Vercel-teamet ditt fra Vercel Marketplace. Du logger inn med Vercel-kontoen din og betaler via Vercel-regningen din, og Vercel-prosjektene dine får traces, logger, oppetidsovervåking og en statusside i Status200, uten at du trenger å sette opp noe for hånd.

Slik fungerer det

Hver Status200-ressurs du legger til i Vercel, er et eget Status200-prosjekt. Vercel gir hvert Vercel-prosjekt du kobler til ressursen, ressursens miljøvariabler, og de sender prosjektets traces til Status200. Drains sender Vercels logger og spans, og produksjonsdomenet til hvert tilkoblet prosjekt får en oppetidsmonitor på ressursens statusside.

flowchart TB resource["En Status200-ressurs<br/>i Vercel-teamet ditt"] --> project["Ressursens<br/>Status200-prosjekt"] resource -->|"miljøvariabler"| apps["De tilkoblede<br/>Vercel-prosjektene dine"] apps -->|"traces, @vercel/otel"| project apps -->|"logg- og trace-drains"| project project --> monitors["En monitor for hvert<br/>produksjonsdomene"] monitors --> page["Ressursens<br/>statusside"]

Fra Vercel-prosjektene dine til Status200

Integrasjonen er for Status200 Cloud (status200.ru). En selvhostet Status200 kan ikke legges til fra Vercel Marketplace: se Selvhostet Status200.

Før du begynner

  • Et Vercel-team, på et hvilket som helst abonnement. Logg- og trace-drains krever Vercels Pro- eller Enterprise-abonnement; traces fra @vercel/otel virker på alle abonnementer.
  • En bekreftet e-postadresse på Vercel-kontoen din. Status200 logger deg inn med den, og oppretter Status200-kontoen din med den hvis du ikke har en.
  • En betalingsmetode i Vercel, for alle abonnementer: monitorer og telemetri faktureres etter bruk, også på Free-abonnementet. Se Abonnementer og fakturering.

Legg til Status200 i Vercel-teamet ditt

  1. Åpne Status200 på Vercel Marketplace

    Åpne Integrations i Vercel-dashbordet, deretter Browse Marketplace, og finn Status200 under Observability. Klikk på Install, og godta vilkårene til Status200.

  2. Velg et abonnement

    Velg Free, Growth eller Scale. Abonnementene er Status200s egne, til prisene på status200.ru/pricing.

  3. Gi ressursen et navn, og velg innstillingene

    Gi ressursen navn etter det den overvåker, for eksempel storefront: Status200-prosjektet og statussiden til ressursen får navn etter den. To innstillinger er slått på fra start:

    • Monitor production domains: en nettstedsmonitor for produksjonsdomenet til hvert Vercel-prosjekt du kobler til.
    • Create a status page: en offentlig statusside for ressursen, som viser disse monitorene.
  4. Koble til prosjektene dine

    Velg Vercel-prosjektene som sender til denne ressursen, og miljøene som får miljøvariablene til ressursen. Ikke gi tilkoblingen et egendefinert prefiks: @vercel/otel leser variablene under deres egne navn.

Ressursen er klar på noen sekunder. Klikk på Open in Status200 for å se prosjektet til ressursen.

Hva du får med hver ressurs

HvaHvor du finner det
Et Status200-prosjekt, oppkalt etter ressursenDu eier det. Teamkameratene dine blir med i det når de åpner det fra Vercel.
En inntaksnøkkel med navnet VercelProsjektinnstillinger → Telemetri og APM → Inntaksnøkler
Miljøvariabler i hvert tilkoblet Vercel-prosjektSettings → Environment Variables for prosjektet i Vercel
En nettstedsmonitor for hvert tilkoblet prosjektMonitorer, oppkalt etter Vercel-prosjektet
En offentlig statussideStatussider, oppkalt etter ressursen

Miljøvariablene er de samme i alle tilkoblede prosjekter:

VariabelVerdi
OTEL_EXPORTER_OTLP_ENDPOINThttps://status200.ru/otlp
OTEL_EXPORTER_OTLP_HEADERSx-status200-token= og inntaksnøkkelen til ressursen
OTEL_EXPORTER_OTLP_PROTOCOLhttp/protobuf
STATUS200_TELEMETRY_INGESTION_KEYInntaksnøkkelen alene, som drains sender

En utrulling får variablene når den bygges: rull ut på nytt etter at du har koblet til et prosjekt.

Send traces med @vercel/otel

@vercel/otel er Vercels OpenTelemetry-pakke for Next.js og de andre rammeverkene Vercel kjører. Den leser OTEL_EXPORTER_OTLP_*-variablene, så et prosjekt som er koblet til ressursen, trenger bare pakken.

  1. Installer pakken

    Bash
    npm install @vercel/otel @opentelemetry/api @opentelemetry/api-logs
  2. Registrer pakken

    Opprett instrumentation.ts i roten av prosjektet, eller i src hvis prosjektet har en slik mappe, og gi tjenesten et navn:

    instrumentation.tsTypeScript
    import { registerOTel } from "@vercel/otel";
    
    export function register(): void {
      registerOTel({ serviceName: "storefront" });
    }
  3. Rull ut

    Rull ut prosjektet. Traces fra prosjektet vises i Spor, under tjenestenavnet.

På Vercels Pro- og Enterprise-abonnementer legger du også til en trace-drain: Vercel sender da Status200 sine egne spans for hver forespørsel, sammen med spans fra applikasjonen din, og @vercel/otel overlater dem til drainen, så ingenting kommer fram to ganger.

Send logger og traces med drains

En drain sender det Vercel registrerer om prosjektene dine, til Status200: en loggdrain sender build-, funksjons-, edge- og forespørselsloggene deres, og en trace-drain deres spans. Drains krever Vercels Pro- eller Enterprise-abonnement, og Vercel fakturerer dataene de sender, på Vercel-regningen din.

  1. Legg til en drain

    Åpne Team Settings → Drains i Vercel, og klikk på Add Drain. Velg Logs eller Traces, og deretter Status200 under Native Integrations.

  2. Velg prosjektene

    Velg prosjektene, og for logger kildene og miljøene. Drainen sender med inntaksnøkkelen til ressursen: det er ingenting å skrive inn.

Hvert Vercel-prosjekt er en tjeneste i Status200, oppkalt etter prosjektet. En logg beholder tidspunktet, nivået og meldingen sin, og forespørselen havner under OpenTelemetrys navn:

Vercel-feltI Status200
projectNameTjenesten, service.name
timestamp, level, messageLoggens tidspunkt, alvorlighetsgrad og brødtekst
deploymentId, environmentvercel.deployment.id, deployment.environment.name
proxy.method, proxy.path, proxy.statusCodehttp.request.method, url.path, vercel.proxy.status_code
traceId, spanIdLoggens trace, lenket til tracen i Spor
Alle andre feltEt attributt under vercel., for eksempel vercel.source

Oppetidsmonitorer og statussiden

Når du kobler til et Vercel-prosjekt, oppretter Status200 en nettstedsmonitor for produksjonsdomenet til prosjektet, som sjekkes fra Status200s sonder, og legger den til på statussiden til ressursen. Et prosjekt som kobles til før sin første produksjonsutrulling, har ikke noe domene ennå: monitoren opprettes ved den utrullingen. Når du kobler fra prosjektet, slettes monitoren.

Hver monitor er en aktiv monitor, som faktureres som alle andre og fungerer som en du har opprettet selv: se Nettsted-overvåking. Vil du ikke ha noen, slår du av Monitor production domains i innstillingene til ressursen i Vercel. Når du slår den på igjen, opprettes monitorene som fortsatt mangler.

Åpne Status200 fra Vercel

Klikk på Open in Status200 på ressursen, eller på en av lenkene dens i Vercel, så er du logget inn i Status200 med e-postadressen til Vercel-kontoen din. Første gang blir du med i prosjektet til ressursen: som administrator hvis du er eier eller medlem av Vercel-teamet, og som medlem hvis du har en av teamets skrivebeskyttede roller.

Finnes det allerede en Status200-konto med den e-postadressen, er det den du logger inn på. En konto som har tofaktorautentisering slått på, eller som tilhører en Status200-administrator, logger i stedet inn med passordet sitt. Du er med i prosjektet likevel.

Abonnementer og fakturering

Slik fungerer det
AbonnementerFree, Growth og Scale, til prisene på status200.ru: abonnementets pris per bruker, aktive monitorer til $1 per monitor per måned, og telemetri per GB.
Hvor du betalerPå Vercel-fakturaen din, én gang i måneden, for hver ressurs. Vercel viser månedens bruk så langt på ressursen, oppdatert hver time.
PrøveperioderIngen belastning så lenge abonnementets prøveperiode varer: verken for brukerne, monitorene eller telemetrien.
Bytte abonnementI Vercel, på ressursen, eller i Status200 under Prosjektinnstillinger → Fakturering og fakturaer → Fakturering. En endring på det ene stedet gjelder begge steder.
Ubetalte fakturaerVercel prøver betalingen på nytt i 15 dager. Etter det er prosjektet utilgjengelig til fakturaen er betalt: dataene beholdes, og ingenting slettes.

På fakturaen har hver ressurs en linje for brukerne, de aktive monitorene, telemetrien og eventuelle påfyllinger av saldoen, i bruksenheter på $0.01.

Fjern Status200

DuHva som skjer
Sletter en ressurs i VercelProsjektet til ressursen slettes, etter at bruken fram til da er fakturert. De tilkoblede Vercel-prosjektene mister miljøvariablene til ressursen ved neste utrulling.
Avinstallerer Status200 fra teametProsjektet til hver ressurs slettes, og den endelige fakturaen sendes.
Sletter prosjektet i Status200Ressursen slettes også i Vercel.
Forsiktig

Å slette et prosjekt sletter monitorene, statussiden, hendelsene og telemetrien til prosjektet for godt. Eksporter først alt du vil beholde.

Selvhostet Status200

En selvhostet Status200 kan ikke legges til fra Vercel Marketplace, som bare klargjør Status200 Cloud. Vercel-prosjektene dine kan likevel sende til den:

  • Traces: angi variablene fra Hva du får med hver ressurs i Settings → Environment Variables for Vercel-prosjektet, med https://YOUR-ONEUPTIME-HOST/otlp som endepunkt og en inntaksnøkkel fra prosjektet ditt.
  • Logger: legg til en egendefinert loggdrain i Team Settings → Drains, til https://YOUR-ONEUPTIME-HOST/telemetry/vercel/v1/logs, i JSON eller NDJSON. Legg til headeren x-status200-token med inntaksnøkkelen din, og sett signeringshemmeligheten til drainen til den samme nøkkelen: Status200 godtar bare leveranser som Vercel har signert med den.

Den samme egendefinerte drainen fungerer på Status200 Cloud, med status200.ru som vert.

Feilsøking

Det kommer ingen traces
  • Rull ut prosjektet på nytt: en utrulling som ble bygget før prosjektet ble koblet til, har ingen OTEL_EXPORTER_OTLP_*-variabler.
  • Kontroller navnene på variablene i Settings → Environment Variables for prosjektet. En tilkobling som er laget med et egendefinert prefiks, gir dem nye navn, og da leser ikke @vercel/otel dem lenger: koble til prosjektet på nytt uten prefiks.
  • Kontroller at instrumentation.ts kaller registerOTel, og, på Next.js 14 og eldre, at experimental.instrumentationHook er slått på i next.config.js.
Vercel viser drainen med feil

Vercel viser svaret fra Status200 på leveransene til drainen:

  • 403 med x-vercel-signature i meldingen: Vercel signerte ikke leveransen med nøkkelen Vercel sender. For en egendefinert drain kontrollerer du x-status200-token-headeren, og setter signeringshemmeligheten til den samme nøkkelen.
  • 401: Status200 kjenner ikke noe prosjekt med nøkkelen drainen sender: den er slettet, eller skrevet feil begge steder. Bruk en nøkkel fra Prosjektinnstillinger → Telemetri og APM → Inntaksnøkler.
  • 422: nøkkelen er slått av. Slå den på igjen på samme side, eller bruk en annen.
Et tilkoblet prosjekt har ingen monitor
  • Monitor production domains er slått av i innstillingene til ressursen i Vercel.
  • Prosjektet har ikke noe produksjonsdomene ennå: monitoren opprettes ved den første produksjonsutrullingen.
  • Abonnementet til prosjektet har så mange aktive monitorer som det tillater: oppgrader abonnementet, og slå deretter Monitor production domains av og på igjen.
Vercel ber deg bekrefte e-postadressen din

Status200 trenger en e-postadresse som Vercel har bekreftet, og en eksisterende Status200-konto med den adressen må også ha fått sin egen adresse bekreftet. Bekreft adressen, og legg deretter til ressursen eller åpne Status200 på nytt.

Neste trinn