Vercel
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.
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/otelvirker 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
Å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.
Velg et abonnement
Velg Free, Growth eller Scale. Abonnementene er Status200s egne, til prisene på status200.ru/pricing.
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.
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/otelleser 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
| Hva | Hvor du finner det |
|---|---|
| Et Status200-prosjekt, oppkalt etter ressursen | Du eier det. Teamkameratene dine blir med i det når de åpner det fra Vercel. |
En inntaksnøkkel med navnet Vercel | Prosjektinnstillinger → Telemetri og APM → Inntaksnøkler |
| Miljøvariabler i hvert tilkoblet Vercel-prosjekt | Settings → Environment Variables for prosjektet i Vercel |
| En nettstedsmonitor for hvert tilkoblet prosjekt | Monitorer, oppkalt etter Vercel-prosjektet |
| En offentlig statusside | Statussider, oppkalt etter ressursen |
Miljøvariablene er de samme i alle tilkoblede prosjekter:
| Variabel | Verdi |
|---|---|
OTEL_EXPORTER_OTLP_ENDPOINT | https://status200.ru/otlp |
OTEL_EXPORTER_OTLP_HEADERS | x-status200-token= og inntaksnøkkelen til ressursen |
OTEL_EXPORTER_OTLP_PROTOCOL | http/protobuf |
STATUS200_TELEMETRY_INGESTION_KEY | Inntaksnø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.
Installer pakken
npm install @vercel/otel @opentelemetry/api @opentelemetry/api-logsRegistrer pakken
Opprett
instrumentation.tsi roten av prosjektet, eller isrchvis prosjektet har en slik mappe, og gi tjenesten et navn:import { registerOTel } from "@vercel/otel"; export function register(): void { registerOTel({ serviceName: "storefront" }); }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.
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.
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-felt | I Status200 |
|---|---|
projectName | Tjenesten, service.name |
timestamp, level, message | Loggens tidspunkt, alvorlighetsgrad og brødtekst |
deploymentId, environment | vercel.deployment.id, deployment.environment.name |
proxy.method, proxy.path, proxy.statusCode | http.request.method, url.path, vercel.proxy.status_code |
traceId, spanId | Loggens trace, lenket til tracen i Spor |
| Alle andre felt | Et 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 | |
|---|---|
| Abonnementer | Free, 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 betaler | På Vercel-fakturaen din, én gang i måneden, for hver ressurs. Vercel viser månedens bruk så langt på ressursen, oppdatert hver time. |
| Prøveperioder | Ingen belastning så lenge abonnementets prøveperiode varer: verken for brukerne, monitorene eller telemetrien. |
| Bytte abonnement | I Vercel, på ressursen, eller i Status200 under Prosjektinnstillinger → Fakturering og fakturaer → Fakturering. En endring på det ene stedet gjelder begge steder. |
| Ubetalte fakturaer | Vercel 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
| Du | Hva som skjer |
|---|---|
| Sletter en ressurs i Vercel | Prosjektet 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 teamet | Prosjektet til hver ressurs slettes, og den endelige fakturaen sendes. |
| Sletter prosjektet i Status200 | Ressursen slettes også i Vercel. |
Å 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/otlpsom 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 headerenx-status200-tokenmed 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/oteldem lenger: koble til prosjektet på nytt uten prefiks. - Kontroller at
instrumentation.tskallerregisterOTel, og, på Next.js 14 og eldre, atexperimental.instrumentationHooker slått på inext.config.js.
Vercel viser drainen med feil
Vercel viser svaret fra Status200 på leveransene til drainen:
403medx-vercel-signaturei meldingen: Vercel signerte ikke leveransen med nøkkelen Vercel sender. For en egendefinert drain kontrollerer dux-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.