Vi er glade for at kunne annoncere udgivelsen af nye endpoints på Kinsta API, der giver dig mulighed for at få adgang til detaljerede analyser om dine applikationer og hente oplysninger om din virksomheds brugere på Kinsta.
Siden lanceringen af vores Applikation Hosting-tjeneste har vi leveret analyser på applikationsniveau, der beskriver din applikations båndbredde, bygge-tid, runtime, CPU- og hukommelsesforbrug, gennemsnitlig responstid, HTTP-anmodninger og langsomste anmodninger via MyKinsta-dashboardet (Applikations > app navn > Analytics).
Nu kan disse metrics tilgås programmatisk via Kinsta API.
Nye metriske slutpunkter til dine applikationer
Du kan nu få adgang til følgende analyseoplysninger via Kinsta API:
- Båndbredde – Total dataoverførsel i den valgte tidsperiode.
- Byggetid – Den samlede tid, det tog at bygge din applikation.
- Runtime – Den samlede tid, applikationen kører efter at være blevet bygget og implementeret.
- HTTP-anmodninger pr. minut – Samlede gennemsnitlige anmodninger pr. minut.
- Gennemsnitlig svartid – Den gennemsnitlige svartid for anmodninger. (Hvis forespørgslen om svartid omfatter parameteren
percentmed værdier på 95 eller 50, returneres svartiderne for P95-latency eller P50-latency). - Langsomste anmodninger – Dette viser dig præcis, hvilke svar der er de langsomste i din applikation.
- CPU-brug – Gennemsnittet af den samlede CPU-brug for den valgte tidsperiode, som en procentdel af instansens CPU-ressourcer.
- Hukommelsesforbrug – Et gennemsnit af det samlede hukommelsesforbrug (RAM) for den valgte tidsperiode.
Kinsta API-dokumentationen indeholder de nødvendige sti- og forespørgselsparametre for at få adgang til disse målinger. For at hente daglige data om båndbreddeforbrug skal du f.eks. sende en GET-forespørgsel til:
https://api.kinsta.com/v2/applications/{id}/metrics/bandwidth
Denne anmodning vil kræve følgende parametre:
- Sti-parameter:
id– Dette er applikations-id’et og vil blive føjet til API-URL’en.
- Forespørgselsparametre:
interval_in_seconds– Dette er påkrævet og måles i sekunder. Hvis du ønsker, at intervallet mellem de returnerede værdier skal være 24 timer, skal du konvertere 24 timer til sekunder, hvilket er 86400.timeframe_startogtimeframe_end– Disse parametre er påkrævede, og ISO 8601-dato-tidsformatet bruges. Det har et generelt format påYYYY-MM-DDThh:mm:ss.sssZ.
Her er en detaljeret oversigt over ISO 8601-dato- og tidsformatet:
- YYYY-MM-DD – Repræsenterer datoen:
- YYYY – Firecifret årstal
- MM – Tocifret måned (01 til 12)
- DD – Tocifret dag i måneden (01 til 31)
- T – Bogstavet T bruges som separator for at skelne tydeligt mellem dato- og tidsdelen.
- hh:mm:ss.sss – Repræsenterer klokkeslættet:
- hh – Tocifret time (00 til 23)
- mm – Tocifret minut (00 til 59)
- ss – Tocifret sekund (00 til 59)
- .sss – Millisekunder, som kan være et til tre cifre, der repræsenterer en brøkdel af et sekund
- Z – Angiver, at tiden er indstillet til UTC (Coordinated Universal Time). Hvis tiden ikke er i UTC, kan der også inkluderes en tidsforskydning i stedet for “Z”, formateret som ±hh:mm, hvor “hh” repræsenterer timeforskellen og “mm” repræsenterer minutforskellen fra UTC.
Tilbage til vores eksempel: Du kan sende en GET-anmodning for at hente daglige data mellem 20. april 2024 og 28. april 2024:
curl -i -X GET \
'https://api.kinsta.com/v2/applications/{application_id}/metrics/bandwidth?interval_in_seconds=86400&timeframe_start=2024-04-20T18%3A10%3A45.511Z&timeframe_end=2024-04-28T18%3A10%3A45.511Z' \
-H 'Authorization: Bearer 'Erstat {application_id} og <YOUR_TOKEN_HERE> med henholdsvis dit applikations-id og API-token. Når du sender denne anmodning, returneres følgende dataformat:
{
"app": {
"id": "MY_APP_ID",
"display_name": "Kinsta-developer-portfolio",
"metrics": {
"timeframe": {
"start": "1713571200000",
"end": "1714262400000"
},
"bandwidth": [
{
"time": "1713571200000",
"value": "18205"
},
{
"time": "1713657600000",
"value": "834750"
},
{
"time": "1713744000000",
"value": "146959"
},
{
"time": "1713830400000",
"value": "142413"
},
{
"time": "1713916800000",
"value": "165352"
},
{
"time": "1714089600000",
"value": "109015"
},
{
"time": "1714176000000",
"value": "628641"
}
]
}
}
}Svaret specificerer tidsrammens start og slut baseret på det, der blev sendt via anmodningen. Hvis du sætter det ind i new Date() -konstruktøren, får du dato/tid-objektet. Desuden returnerer båndbredden et array af objekter, der indeholder tiden (tidsstempel givet for hver dag – baseret på det indstillede interval) og værdien i bytes.
Når du konverterer hver af disse data i overensstemmelse hermed, betyder det følgende:
Tidsramme
- Start: 2024-04-20 00:00:00
- Slut: 2024-04-29 00:00:00
Båndbredde (omregnet til MB)
- Tid: 2024-04-20 00:00:00, Værdi: 0.0174 MB
- Tid: 2024-04-21 00:00:00, Værdi: 0.7961 MB
- Tid: 2024-04-22 00:00:00, Værdi: 0.1402 MB
- Tid: 2024-04-23 00:00:00, Værdi: 0.1358 MB
- Tid: 2024-04-24 00:00:00, Værdi: 0.1577 MB
- Tid: 2024-04-26 00:00:00, Værdi: 0.1040 MB
- Tid: 2024-04-27 00:00:00, Værdi: 0.5995 MB
- Tid: 2024-04-28 00:00:00, Værdi: 5.8086 MB
Det betyder, at du programmatisk kan få oplysninger om hver af disse analytiske oplysninger til en anden platform uden at skulle navigere i MyKinsta-dashboardet for hver applikation.
For eksempel kan du oprette en Slackbot, der bruger Slacks Slash-kommando til at få adgang til disse oplysninger fra Slack eller oprette en påmindelse for at informere dig, når den daglige båndbredde, CPU eller hukommelsesbrug krydser en bestemt tærskel.
Få adgang til virksomhedens brugere med Kinsta API
Som svar på kundeanmodninger har vi tilføjet et endpoint til at hente oplysninger om Kinsta-kontoens virksomhedsbrugere, herunder deres fulde navn, e-mail og gravatar-billed-URL.
Dette stemmer overens med vores forpligtelse til at prioritere funktioner baseret på brugerfeedback. Hvis du mener, at et specifikt værktøj eller endpoint bør inkluderes i Kinsta API, er du velkommen til at sende din feedback.
For at få adgang til disse data skal du sende en GET-anmodning til: https://api.kinsta.com/v2/company/{company_id}/users. Sørg for at erstatte {company_id} med dit virksomheds-id. Dette vil returnere et svar som:
{
"company": {
"users": [
{
"user": {
"id": "54fb80af-576c-4fdc-ba4f-b596c83f15a1",
"email": "[email protected]",
"image": "https://www.gravatar.com/avatar/205e460b479e2e5b48aec07710c08d50",
"full_name": "John Doe"
}
}
]
}
}Kom i gang med Kinsta API i dag
For at bruge Kinsta API skal du have en aktiv Kinsta-konto med mindst et WordPress-websted, en applikation eller en database i MyKinsta. Sådan genererer du en API-nøgle:
- Gå til dit MyKinsta-dashboard.
- Naviger til siden API-nøgler (Dit navn > Virksomhedsindstillinger > API-nøgler).
- Klik på Opret API-nøgle.
- Vælg en udløbsdato, eller indstil en brugerdefineret startdato og et antal timer, hvor nøglen skal udløbe.
- Giv nøglen et unikt navn.
- Klik på Generer.
Når API-nøglen er oprettet, skal du sørge for at kopiere den og gemme den et sikkert sted, da det er den eneste gang, du kan se den. Vi anbefaler, at du bruger en password manager som 1Password til at dele den sikkert.
Der er meget, der kan gøres med Kinsta API. Du er velkommen til at tjekke vores dokumentation for at forstå, hvad der er muligt med API’en, hvordan du kommer i gang, og de forskellige tilladelsesniveauer og grænser for API’en.
Du kan også tjekke vores tidligere changelogs for Kinsta API:
- Introduktion til Kinsta API: Kraften i automatisering til site management
- Introduktion af nye Kinsta API-endpoints: Miljø CRUD, Edge Caching, Application Deployment
- Nye Kinsta API-endpoints: Ryd CDN-cache og push-miljø
- Nye Kinsta API-endpoints forbedrer WordPress-site management
- 3 nye Kinsta API-endpoints til applikationshosting (CDN, Edge Caching og clear cache)