Gå til indhold
Vercel

Vercel

Vis som Markdown

Tilføj Status200 til dit Vercel-team fra Vercel Marketplace. Du logger ind med din Vercel-konto og betaler via din Vercel-regning, og dine Vercel-projekter får traces, logs, oppetidsovervågning og en statusside i Status200, uden at du skal sætte noget op i hånden.

Sådan fungerer det

Hver Status200-ressource, du tilføjer i Vercel, er et Status200-projekt for sig. Vercel giver hvert Vercel-projekt, du forbinder til ressourcen, ressourcens miljøvariabler, og de sender projektets traces til Status200. Drains sender Vercels logs og spans, og hvert forbundet projekts produktionsdomæne får en oppetidsmonitor på ressourcens statusside.

flowchart TB resource["En Status200-ressource<br/>i dit Vercel-team"] --> project["Dens Status200-projekt"] resource -->|"miljøvariabler"| apps["Dine forbundne<br/>Vercel-projekter"] apps -->|"traces, @vercel/otel"| project apps -->|"log- og trace-drains"| project project --> monitors["En monitor for hvert<br/>produktionsdomæne"] monitors --> page["Ressourcens<br/>statusside"]

Fra dine Vercel-projekter til Status200

Integrationen er til Status200 Cloud (status200.ru). Et selvhostet Status200 kan ikke tilføjes fra Vercel Marketplace: se Selvhostet Status200.

Før du går i gang

  • Et Vercel-team, på en hvilken som helst plan. Log- og trace-drains kræver Vercels Pro- eller Enterprise-plan; traces fra @vercel/otel virker på alle planer.
  • En bekræftet e-mailadresse på din Vercel-konto. Status200 logger dig ind med den og opretter din Status200-konto med den, hvis du ikke har en.
  • En betalingsmetode i Vercel, for alle planer: monitorer og telemetri faktureres efter forbrug, også på Free-planen. Se Planer og fakturering.

Tilføj Status200 til dit Vercel-team

  1. Åbn Status200 på Vercel Marketplace

    Åbn Integrations i Vercel-dashboardet, derefter Browse Marketplace, og find Status200 under Observability. Klik på Install, og acceptér Status200s vilkår.

  2. Vælg en plan

    Vælg Free, Growth eller Scale. Planerne er Status200s egne, til priserne på status200.ru/pricing.

  3. Navngiv ressourcen efter det, den overvåger, for eksempel storefront: dens Status200-projekt og dens statusside får navn efter den. To indstillinger er slået til fra start:

    • Monitor production domains: en webstedsmonitor for produktionsdomænet for hvert Vercel-projekt, du forbinder.
    • Create a status page: en offentlig statusside for ressourcen, som viser de monitorer.
  4. Forbind dine projekter

    Vælg de Vercel-projekter, der sender til denne ressource, og de miljøer, der får dens miljøvariabler. Giv ikke forbindelsen et brugerdefineret præfiks: @vercel/otel læser variablerne under deres egne navne.

Ressourcen er klar på få sekunder. Klik på Open in Status200 for at se dens projekt.

Hvad du får med hver ressource

HvadHvor du finder det
Et Status200-projekt, opkaldt efter ressourcenDu ejer det. Dine teamkammerater kommer med i det, når de åbner det fra Vercel.
En indtagelsesnøgle med navnet VercelProjektindstillinger → Telemetri og APM → Indtagelsesnøgler
Miljøvariabler i hvert forbundet Vercel-projektProjektets Settings → Environment Variables i Vercel
En webstedsmonitor for hvert forbundet projektMonitorer, opkaldt efter Vercel-projektet
En offentlig statussideStatussider, opkaldt efter ressourcen

Miljøvariablerne er de samme i alle forbundne projekter:

VariabelVærdi
OTEL_EXPORTER_OTLP_ENDPOINThttps://status200.ru/otlp
OTEL_EXPORTER_OTLP_HEADERSx-status200-token= og ressourcens indtagelsesnøgle
OTEL_EXPORTER_OTLP_PROTOCOLhttp/protobuf
STATUS200_TELEMETRY_INGESTION_KEYIndtagelsesnøglen alene, som drains sender

En udrulning får variablerne, når den bygges: udrul igen, når du har forbundet et projekt.

Send traces med @vercel/otel

@vercel/otel er Vercels OpenTelemetry-pakke til Next.js og de andre frameworks, Vercel kører. Den læser OTEL_EXPORTER_OTLP_*-variablerne, så et projekt, der er forbundet til ressourcen, behøver kun pakken.

  1. Installér pakken

    Bash
    npm install @vercel/otel @opentelemetry/api @opentelemetry/api-logs
  2. Registrér pakken

    Opret instrumentation.ts i projektets rod, eller i src, hvis projektet har den mappe, og navngiv tjenesten:

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

    Udrul projektet. Dets traces vises i Spor under tjenestenavnet.

På Vercels Pro- og Enterprise-planer skal du også tilføje et trace-drain: Vercel sender så Status200 sine egne spans for hver anmodning sammen med din applikations, og @vercel/otel overlader dem til drainet, så intet ankommer to gange.

Send logs og traces med drains

Et drain sender det, Vercel registrerer om dine projekter, til Status200: et log-drain sender deres build-, funktions-, edge- og anmodningslogs, og et trace-drain deres spans. Drains kræver Vercels Pro- eller Enterprise-plan, og Vercel fakturerer de data, de sender, på din Vercel-regning.

  1. Tilføj et drain

    Åbn Team Settings → Drains i Vercel, og klik på Add Drain. Vælg Logs eller Traces og derefter Status200 under Native Integrations.

  2. Vælg projekterne

    Vælg projekterne og, for logs, kilderne og miljøerne. Drainet sender med ressourcens indtagelsesnøgle: der er intet at taste.

Hvert Vercel-projekt er en tjeneste i Status200, opkaldt efter projektet. En log beholder sit tidspunkt, sit niveau og sin besked, og dens anmodning gemmes under OpenTelemetrys navne:

Vercel-feltI Status200
projectNameTjenesten, service.name
timestamp, level, messageLoggens tidspunkt, alvorlighed 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, linket til tracet i Spor
Alle andre felterEn attribut under vercel., for eksempel vercel.source

Oppetidsmonitorer og statussiden

Når du forbinder et Vercel-projekt, opretter Status200 en webstedsmonitor for dets produktionsdomæne, som tjekkes fra Status200s sonder, og føjer den til ressourcens statusside. Et projekt, der forbindes før sin første produktionsudrulning, har endnu intet domæne: dets monitor oprettes ved den udrulning. Når du frakobler projektet, slettes dets monitor.

Hver monitor er en aktiv monitor, der faktureres som enhver anden og virker som en, du selv har oprettet: se Websted-monitor. Vil du ikke have nogen, så slå Monitor production domains fra i ressourcens indstillinger i Vercel. Slår du den til igen, oprettes de monitorer, der stadig mangler.

Åbn Status200 fra Vercel

Klik på Open in Status200 på ressourcen, eller på et af dens links i Vercel, så er du logget ind i Status200 med din Vercel-kontos e-mailadresse. Første gang kommer du med i ressourcens projekt: som administrator, hvis du er ejer eller medlem af Vercel-teamet, og som medlem, hvis du har en af teamets skrivebeskyttede roller.

Findes der allerede en Status200-konto med den e-mailadresse, er det den, du logger ind på. En konto, der har totrinsgodkendelse slået til, eller som tilhører en Status200-administrator, logger i stedet ind med sin adgangskode. Du er med i projektet alligevel.

Planer og fakturering

Sådan fungerer det
PlanerFree, Growth og Scale, til priserne på status200.ru: planens pris pr. bruger, aktive monitorer til $1 pr. monitor pr. måned og telemetri pr. GB.
Hvor du betalerPå din Vercel-faktura, én gang om måneden, for hver ressource. Vercel viser månedens forbrug indtil nu på ressourcen, opdateret hver time.
PrøveperioderIngen betaling, så længe planens prøveperiode varer: hverken for brugerne, monitorerne eller telemetrien.
Skift af planI Vercel, på ressourcen, eller i Status200 under Projektindstillinger → Fakturering og fakturaer → Fakturering. En ændring det ene sted gælder begge steder.
Ubetalte fakturaerVercel prøver betalingen igen i 15 dage. Derefter er projektet utilgængeligt, indtil fakturaen er betalt: dets data bevares, og intet slettes.

På fakturaen har hver ressource en linje for sine brugere, sine aktive monitorer, sin telemetri og eventuelle genopfyldninger af saldoen, i forbrugsenheder på $0.01.

Fjern Status200

DuHvad der sker
Sletter en ressource i VercelDens projekt slettes, efter at forbruget indtil da er faktureret. De forbundne Vercel-projekter mister dens miljøvariabler ved deres næste udrulning.
Afinstallerer Status200 fra teametHver ressources projekt slettes, og den endelige faktura sendes.
Sletter projektet i Status200Ressourcen slettes også i Vercel.
Forsigtig

At slette et projekt sletter dets monitorer, statusside, hændelser og telemetri for altid. Eksportér først alt, du vil beholde.

Selvhostet Status200

Et selvhostet Status200 kan ikke tilføjes fra Vercel Marketplace, som kun klargør Status200 Cloud. Dine Vercel-projekter kan stadig sende til det:

  • Traces: angiv variablerne fra Hvad du får med hver ressource i Vercel-projektets Settings → Environment Variables, med https://YOUR-ONEUPTIME-HOST/otlp som endpoint og en indtagelsesnøgle fra dit projekt.
  • Logs: tilføj et brugerdefineret log-drain i Team Settings → Drains til https://YOUR-ONEUPTIME-HOST/telemetry/vercel/v1/logs, i JSON eller NDJSON. Tilføj headeren x-status200-token med din indtagelsesnøgle, og sæt drainets signeringshemmelighed til den samme nøgle: Status200 tager kun imod leveringer, som Vercel har signeret med den.

Det samme brugerdefinerede drain virker på Status200 Cloud, med status200.ru som vært.

Fejlfinding

Der kommer ingen traces
  • Udrul projektet igen: en udrulning, der blev bygget, før projektet blev forbundet, har ingen OTEL_EXPORTER_OTLP_*-variabler.
  • Kontrollér variablernes navne i projektets Settings → Environment Variables. En forbindelse, der er oprettet med et brugerdefineret præfiks, omdøber dem, og så læser @vercel/otel dem ikke længere: forbind projektet igen uden præfiks.
  • Kontrollér, at instrumentation.ts kalder registerOTel, og, på Next.js 14 og ældre, at experimental.instrumentationHook er slået til i next.config.js.
Vercel viser drainet med fejl

Vercel viser Status200s svar på drainets leveringer:

  • 403 med x-vercel-signature i beskeden: Vercel signerede ikke leveringen med den nøgle, Vercel sender. For et brugerdefineret drain skal du kontrollere dets x-status200-token-header og sætte dets signeringshemmelighed til den samme nøgle.
  • 401: Status200 kender intet projekt med den nøgle, drainet sender: den er slettet eller tastet forkert begge steder. Brug en nøgle fra Projektindstillinger → Telemetri og APM → Indtagelsesnøgler.
  • 422: nøglen er slået fra. Slå den til igen på samme side, eller brug en anden.
Et forbundet projekt har ingen monitor
  • Monitor production domains er slået fra i ressourcens indstillinger i Vercel.
  • Projektet har endnu intet produktionsdomæne: dets monitor oprettes ved dets første produktionsudrulning.
  • Projektets plan har så mange aktive monitorer, som den tillader: opgradér planen, og slå derefter Monitor production domains fra og til igen.
Vercel beder dig bekræfte din e-mailadresse

Status200 kræver en e-mailadresse, som Vercel har bekræftet, og en eksisterende Status200-konto med den adresse skal også selv have fået adressen bekræftet. Bekræft adressen, og tilføj derefter ressourcen, eller åbn Status200 igen.

Næste trin