Skapa och hantera meddelandekanaler | Molnövervakning | Google Cloud, Form E -postmeddelanden – Google Workspace Marketplace
Google Notification
Contents
- 1 Google Notification
- 1.1 Skapa och hantera meddelandekanaler
- 1.2 Innan du börjar
- 1.3 Skapa en aviseringskanal
- 1.3.1 E-postadress
- 1.3.2 Mobil-app
- 1.3.3 Pagerduty
- 1.3.4 SMS
- 1.3.5 Slak
- 1.3.6 Webhooks
- 1.3.7 Pub/sub
- 1.3.7.1 Innan du börjar
- 1.3.7.2 Aktivera pub/sub -API och skapa ett ämne
- 1.3.7.3 Konfigurera aviseringar för ett ämne
- 1.3.7.4 Auktorisera servicekontot
- 1.3.7.5 Definiera anmälningskanalen i en varningsregel
- 1.3.7.6 Exempel på diagram
- 1.3.7.7 JSON -exempel
- 1.3.7.8 Schemastruktur, version 1.2
- 1.3.7.9 Regler för övergivande
- 1.3.8 Skapa en kedja på begäran
- 1.4 Testa en anmälningskanal
- 1.5 Redigera och ta bort meddelandekanaler
- 1.6 Visa tidningarna för anmälningskanalen
- 1.7 Google Notification
Det här avsnittet beskriver version 1.2 i nyttolastdiagrammet. Vissa fält kanske inte visas i alla returnerade paket eller presenterar tomma värden, beroende på konfigurationen av varningsregeln, tillståndet för incidenten eller den övervakade resursen. Vissa fält använder integrerade strukturer som värden. Dessa strukturer beskrivs genom referens, eftersom deras innehåll också kan variera.
Skapa och hantera meddelandekanaler
Detta dokument förklarar hur man konfigurerar aviseringskanaler med Google Cloud -konsolen. Molnövervakning använder dessa kanaler för att varna dig eller skicka ett meddelande till ditt On -Call -team när en varningsregel utlöses. När du skapar en varningsregel kan du välja användare som får ett meddelande genom att välja dem från listan över konfigurerade aviseringskanaler. Till exempel kan du konfigurera varningar som övervakar beräkna motorinstanser för att publicera ett pub/subämne och varna Slack -kanalen för On -Call -teamet.
Om din favoritmeddelandekanal inte är kompatibel, överväg att skapa en pipeline som är baserad på att skicka aviseringar till pub/sub. För att få ett Python -exempel med hjälp av kolv, se CREATE PERSONALISERA AVSLUTNINGAR SIDA MED MOLDA MONTROLLERING OCH MOLD RUN. För andra exempel, se GIT Cloud-Alerting-Notification-Forwarding Deposit.
För att konfigurera aviseringskanaler med molnövervaknings -API, se Skapa och hantera API -meddelandekanaler.
Lade märke till : Data som skickas till kedjemottagare kan innehålla känslig information. Kontakta dina regleringsmetoder innan du skapar aviseringskanalen.
Mer information om meddelanden om varningsreglerna finns i följande sidor:
- För mer information om förseningen mellan början av ett problem och skapandet av en varning, se latensavsnittet för aviseringar.
- För mer information om antalet aviseringar som genererats för en varningsregel, se avsnittet Incident Notifications.
Som standard skickar en varningsregel endast anmälan till skapandet av en incident. För att få en anmälan när händelsen är öppen eller stängd, ändra varningsregeln. Välj i avsnittet om aviseringar Meddela stängningen av händelsen.
Innan du börjar
För att få de godkännanden som är nödvändiga för att visa och konfigurera meddelandekanalerna med Google Cloud -konsolen, be din administratör att tilldela dig IAM -redigeringsövervakningsrollen (roller/övervakning.Redaktör) på ditt projekt. För mer information om tilldelningen av roller, se avsnittet Hantera åtkomst.
Du kan också få nödvändiga auktorisationer via personliga roller eller andra fördefinierade roller.
Om du vill veta mer om molnövervakningsroller, se CONTROL ACCESS -sidan med identitet och åtkomsthantering.
Skapa en aviseringskanal
När du skapar en varningsregel kan du välja vilken anmälningskanal som är konfigurerad och lägga till den i din regel. Du kan förkonfigurera dina meddelandekanaler eller konfigurera dem som en del av skapandet av en varningsregel. Mer information finns i Create A Channel On Demand.
Lade märke till : Vi rekommenderar att du skapar flera anmälningskanaler för redundansändamål. Google har ingen kontroll över ett stort antal leveranssystem efter att ha överfört meddelandet till dem. Dessutom är endast en Google -tjänst kompatibel med Cloud Mobile App, PagerDuty, Webhooks och Slacks. Om du använder en av dessa meddelandekanaler, använd redundant meddelanden, SMS eller pub/sub.
För att skapa en aviseringskanal med Google Cloud -konsolen följer du de specifika instruktionerna i kanalen i följande tabell:
E-postadress
För att lägga till en e-postmeddelande kanal, fortsätt enligt följande:
- Välj i Google Cloud -konsolen Övervakning, Sedan meddelandenVarna, eller klicka på följande knapp: Åtkomst till varningsgränssnittet
- Klicka på Ändra meddelandekanaler.
- I avsnittet E-post, Klicka på Ny.
- Ange en enda e -postadress och en beskrivning.
- Klicka på Spara.
Om du använder en grupp-e-postadress som en meddelandekanal för en varningsregel, konfigurera gruppen för att acceptera e-post från [email protected] .
Du kan skapa meddelandekanaler när du skapar en varningsregel. För mer information, se skapa en kedja på begäran.
Mobil-app
Använd Google Cloud: s mobilapplikation för att övervaka resurserna för Google Cloud -konsolen och övervaka information var du än är. Meddelandena om mobilapplikationen för Google Cloud -konsolen skickas till en specifik enhet eller användare:
- Värdet Enhet (Enhet) indikerar att aviseringar endast skickas till den specifika enheten som har skapat aviseringskanalen. För enhetsnivåer på enhetsskalan, fältet Visningsnamn (Namn att visa) Innehåller enhetsinformation.
- Användare Anger att aviseringar skickas till alla dina enheter som Google Cloud Console -mobilapplikationen är installerad.
Molnövervakning bestämmer omfattningen av aviseringar när du skapar kanalen. Du kan varken välja eller ändra omfattningen.
För att konfigurera en mobilapplikationsmeddelandekanal i Google Cloud -konsolen för ett specifikt Google Cloud -projekt, fortsätt enligt följande:
- Installera Google Cloud Console Mobile Application från applikationens nedladdningsplattform för din mobila enhet.
- Välj ett projekt som ska visas i Google Cloud Console Mobile Application. När projektet har valts uppstår ett utbyte av data mellan applikationen och det valda Google Cloud -projektet. En aviseringskanal skapas när det inte finns något. Efter några minuter listas det i avsnittet Mobil enheter på sidan Meddelande kanaler.
För att lägga till din mobila enhet som en anmälningskanal för en varningsregel, gå till avsnittet Meddelanden och välj Google Cloud Console (mobil), Välj sedan din mobila enhet från listan.
Pagerduty
Integration med PagerDuty tillåter enkelriktad eller dubbelriktad synkronisering med övervakning. Oavsett din konfiguration gäller följande villkor:
- När en incident skapas vid övervakning är en spegelhändelse också öppen i PagerDuty.
- Du kan inte använda PagerDuty för att stänga en övervakningshändelse.
Om du använder en -vägsynkronisering och korrigerar händelsen i PagerDuty, är tillståndet för händelsen i PagerDuty dissocierad från tillståndet för incidenten vid övervakning. Om du löser en incident i PagerDuty är den definitivt stängd i PagerDuty och kan inte öppnas igen.
Om du använder dubbelriktad synkronisering kontrollerar övervakning av tillståndet som anges av PagerDuty. Om du korrigerar händelsen i PagerDuty och den är öppen genom övervakning, öppnas händelsen igen i PagerDuty.
För att konfigurera aviseringarna PagerDuty, fortsätt enligt följande:
- I pagerduty : Skapa ett PagerDuty -konto på PagerDuty -webbplatsen.
- Lägg till PagerDuty Notification Channel:
- Välj i Google Cloud -konsolen Övervakning, Sedan meddelandenVarna, eller klicka på följande knapp: Åtkomst till varningsgränssnittet
- Klicka på Ändra meddelandekanaler.
- I avsnittet Pagerduty, Klicka på Ny.
- Ange den Visningsnamn (Namn för att visa). Detta namn måste motsvara det som tillhandahålls till PagerDuty när du har lagt till integrationen.
- Ange den Integrationstjänstnyckel genereras av PagerDuty i fältet Servicenyckel.
- Klicka på Spara.
- Öppna pagerduty
- Välj Konfiguration, Välj Tjänster, sedan det servicenamn du angav när du konfigurerade integration.
- Klicka på Ändra parametrarna, Välj Skapa incidenter, Avmarkera sedan lådan Skapa varningar och incidenter.
När du skapar en varningsregel väljer du Pagerduty i avsnittet Meddelanden Och välj din PagerDuty -konfiguration.
JSON PagerDuty -paketet är i följande format:
För att visa ett exempel och detaljfältschemat, utveckla följande avsnitt.
JSON -exempel
Som standard försöker Alert Backend generera ett JSON -paket i version 1 -format.2. För mer information om denna formatering, se nästa avsnitt.
Här är ett exempel på denna typ av paket:
< "incident": < "incident_id": "0.opqiw61fsv7p", "scoping_project_id": "internal-project", "scoping_project_number": 12345, "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project", "started_at": 1577840461, "ended_at": 1577877071, "state": "closed", "resource_id": "11223344", "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3", "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3", "resource_type_display_name": "VM Instance", "resource": < "type": "gce_instance", "labels": < "instance_id": "11223344", "project_id": "internal-project", "zone": "us-central1-c" >>, "Metrisk": < "type": "compute.googleapis.com/instance/cpu/utilization", "displayName": "CPU utilization", "labels": < "instance_name": "the name of the VM instance" >>, "metadata": < "system_labels": < "labelkey": "labelvalue" >, "User_labels": < "labelkey": "labelvalue" >>, "Policy_name": "Monitor-Project-Cluster", "policy_user_labels": < "user-label-1" : "important label", "user-label-2" : "another label" >, "Condition_name": "VM Instans - CPU -användning [max]", "Threshold_value": "0.9 "," observerad_value ":" 0.835 "," Condition ": < "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789", "displayName": "VM Instance - CPU utilization [MAX]", "conditionThreshold": < "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"", "aggregations": [ < "alignmentPeriod": "120s", "perSeriesAligner": "ALIGN_MEAN" >], "jämförelse": "jämförelse_gt", "tröskelvärde": 0.9, "varaktighet": "0s", "trigger": < "count": 1 >>>, "dokumentation": < "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n", "mime_type": "text/markdown" >, "Sammanfattning": "CPU:.835.">," version ":" 1.2 ">
Schemastruktur, version 1.2
Det här avsnittet beskriver version 1.2 i nyttolastdiagrammet. Vissa fält kanske inte visas i alla returnerade paket eller presenterar tomma värden, beroende på konfigurationen av varningsregeln, tillståndet för incidenten eller den övervakade resursen. Vissa fält använder integrerade strukturer som värden. Dessa strukturer beskrivs genom referens, eftersom deras innehåll också kan variera.
I ett returnerat paket kan fälten visas i vilken ordning som helst. I följande beskrivning är de organiserade i relaterade grupper.
<
“version”: “1.2 “,
“incident”:: < Incidentinformation “Incident_id” : kedja; ID genererad för denna incident.
“scoping_project_id” : Kanal, ID för projektet som är värd för mätvärdena.
“Scoping_project_number” : projektnummerövervakning
“URL” : kanal, URL för Google Cloud -konsolen för denna incident.
“Startade_at” : Antal, tid (i sekunder av Epoch Unix) där händelsen öppnades.
“Ended_at” : nummer (i sekunder Epoch Unix) under vilken händelsen stängdes. Endast informerad när staten är stängd .
“Stat” : kedja, villkor för händelsen: öppen eller stängd . Om värdet är öppet är slut_at noll.
“Sammanfattning” : kedja, textöversikt av incidenten genererad.
“apigee_url” : kedja, apigee url av denna incident, endast för de typer av apigee -miljö och proxy* resurser* .
“Observed_value” : kedja, observerat värde efter att ha utlöst/löst varningen, kan vara tomt om tillståndet har löpt ut.Information om den övervakade resursen som händelsen öppnades.
“Resurs”:: <
“snäll” : kedja, identifierare av typen av övervakad resurs med förbehåll för en varning (till exempel gce_instance; se lista över övervakade resurser).
“Etiketter” : Objekt/nyckelvallar för etiketter associerade med den övervakade resursen.
>,
“Resource_type_display_name” : kedja, namn för att visa vilken typ av övervakad resurs.
“Resource_id” : kedja, instans -ID för den övervakade resursen, samma värde som resurs.etiketter.instans_id .
“Resource_display_name” : kedja, namn för att visa övervakade resurser.
“Resursnamn” : kedja, namn som genereras för denna övervakade resurs; Innehåller värdena på andra fält.Information om typen av metriska tidsseriedata.
“Metrisk”:: <
“snäll” : kedja, identifierare av typen av metrisk med förbehåll för en varning (till exempel beräkna.googeapis.com/instans/cpu/användning; Se lista över mätvärden).
“Displayename” : kedja, namn för att visa metrisk typ.
“Etiketter” : Objekt/värdepar för etiketter associerade med mätvärden.
>,
“Metadata”:: <
“System_labels” : Objekt/nyckelparpar för systemmetadatetiketter.
“User_labels” : Objekt/nyckelknappar för användarmetadatetiketter.
>,Information om varningsregeln och villkoret som öppnade/löste händelsen.
Värdena extraheras från det berörda AlertPolicy -objektet.“Policy_name” : kedja, namn för att visa för varningsregeln.
“Policy_user_labels” : Nyckel/värdepar för alla användarformuleringar associerade med regeln.
“dokumentation” : Objekt, struktur integrerad i dokumentationsformat .
“skick” : objekt, struktur integrerad i tillståndsformat .
“Condition_name” : kedja, namn för att visa tillstånd, samma värde som tillstånd.tvist .
“Tröskelvärde” : kedja (tröskelvärde för detta tillstånd) kan vara tomt om tillståndet inte är ett tröskelvillkor.
>,
>Regler för övergivande
Nyttolastsystemet omfattas av förordningarna som rör övergivandet av Google Cloud som beskrivs i avsnitt 1.4 (d) Användningsvillkor för Google Cloud Platform. Observera att diagrammet inte styr formaten för de genererade fältvärdena och att dessa format kan ändras utan föregående meddelande. Till exempel händelse.Sammanfattning, incident.dokumentation.glad och händelse.URL är avsedda att inkludera data som tillhör deras fält, men schemat har inga begränsningar för att garantera en exakt analys av dessa fält. Du kan använda värdet som helhet och förvänta dig att det respekterar förordningarna som rör övergivningar, men litar inte på analysen av de genererade fälten.
SMS
För att konfigurera aviseringar med SMS, fortsätt enligt följande:
- Välj i Google Cloud -konsolen Övervakning, Sedan meddelandenVarna, eller klicka på följande knapp: Åtkomst till varningsgränssnittet
- Klicka på Ändra meddelandekanaler.
- I avsnittet SMS, Klicka på Lägg till.
- Informera dialogrutan och klicka sedan på Spara.
När du konfigurerar din varningsregel väljer du vilken typ av avisering SMS Och välj ett validerat telefonnummer från listan.
Slak
Lade märke till : För att utföra dessa steg måste du vara ägare eller administratör av Workspace Slack. För mer information, se Hantera inbjudningsförfrågningar.
Integrering av övervakning med Slack gör att dina varningsregler kan publicera data på en Slack -kanal när en incident skapas. För att konfigurera slackmeddelanden, fortsätt enligt följande:
- I slak : Skapa en arbetsyta och en Slack -kanal på Slack -webbplatsen. Spara kanaladressen.
- Välj i Google Cloud -konsolen Övervakning, Sedan meddelandenVarna, eller klicka på följande knapp: Åtkomst till varningsgränssnittet
- Klicka på Ändra meddelandekanaler.
- I avsnittet Slak, Klicka på Lägg till För att öppna sidan Slack Connection:
- Välj din Slack Workspace.
- Klicka på Att tillåta För att låta molnövervakning komma åt din slack arbetsyta. Denna åtgärd tar dig tillbaka till övervakningskonfigurationssidan i din aviseringskanal.
- På fältet Slackkanalnamn, Ange namnet på den slackkanalen du vill använda för aviseringar.
- På fältet Molnvarning, Ange en kort utredning. Övervakning visar värdet på detta fält på sidan Aviseringskanal.
- (Valfritt) För att testa anslutningen mellan molnövervakning och din slack arbetsyta, klicka på Skicka ett testmeddelande. Om anslutningsresultatet är ett meddelande detta är en testvarning. visas i Slack Notification Channel som du angav. Konsultera aviseringskanalen för att bekräfta mottagningen.
/snabb @Google molnövervakning
När du skapar en varningsregel väljer du Slak i avsnittet Meddelanden Och välj din slackkonfiguration.
Webhooks
Lade märke till: Webhooks är bara kompatibla med offentliga uppsägningspunkter. Om du behöver meddelanden för att skickas till en icke -offentlig uppsägningspunkt, skapa en pub/submeddelandekanal och konfigurera ett prenumeration på puben/suben. Mer information finns i avsnittet Failure of Webhook när du är konfigurerad för en privat uppsägningspunkt.
Lade märke till: Om en molnfunktion är konfigurerad som en Webbhook -uppsägningspunkt för en aviseringskanal, se till att användaren som ringer funktionen har den erforderliga autentiseringstillståndet. För mer information, se avsnitten Autentifiera funktioner för funktionssamtal och aktivera åtkomst till en funktion.
Uppmärksamhet: För att få aviseringar med Google Cat, distribuera en Cloud Run -tjänst och skicka dina meddelanden till AD. För ett exempel på denna konfiguration, se Skapa personliga aviseringar med molnövervakning och molnkörning.
Konfigurera inte en webhook -meddelande och konfigurera sedan Google Cat för att använda denna webhook.
För att konfigurera aviseringarna från WebHook, fortsätt enligt följande:
- Webhooks Manager : Identifiera URL: n för den offentliga uppsägningspunkten som kommer att ta emot data från övervakning av Webhooks.
- Välj i Google Cloud -konsolen Övervakning, Sedan meddelandenVarna, eller klicka på följande knapp: Åtkomst till varningsgränssnittet
- Klicka på Ändra meddelandekanaler.
- I avsnittet Webhook, Klicka på Lägg till.
- Fyll i dialogrutan.
- Klicka på Testa anslutningen För att skicka en testladdning av testet vid slutpunkten för webhook. Du kan komma åt mottagningspunkten för mottagning för att kontrollera sändningen.
- Klicka på Spara.
När du skapar en varningsregel väljer du Webhook i avsnittet Meddelanden Och välj din webhook -konfiguration. Meddelandena som skickas av felrapportering Följ diagram 1.0, medan de som skickas genom att övervaka Följ diagram 1.2:
JSON -exempel
Som standard försöker Alert Backend generera ett JSON -paket i version 1 -format.2. För mer information om denna formatering, se nästa avsnitt.
Här är ett exempel på denna typ av paket:
< "incident": < "incident_id": "0.opqiw61fsv7p", "scoping_project_id": "internal-project", "scoping_project_number": 12345, "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project", "started_at": 1577840461, "ended_at": 1577877071, "state": "closed", "resource_id": "11223344", "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3", "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3", "resource_type_display_name": "VM Instance", "resource": < "type": "gce_instance", "labels": < "instance_id": "11223344", "project_id": "internal-project", "zone": "us-central1-c" >>, "Metrisk": < "type": "compute.googleapis.com/instance/cpu/utilization", "displayName": "CPU utilization", "labels": < "instance_name": "the name of the VM instance" >>, "metadata": < "system_labels": < "labelkey": "labelvalue" >, "User_labels": < "labelkey": "labelvalue" >>, "Policy_name": "Monitor-Project-Cluster", "policy_user_labels": < "user-label-1" : "important label", "user-label-2" : "another label" >, "Condition_name": "VM Instans - CPU -användning [max]", "Threshold_value": "0.9 "," observerad_value ":" 0.835 "," Condition ": < "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789", "displayName": "VM Instance - CPU utilization [MAX]", "conditionThreshold": < "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"", "aggregations": [ < "alignmentPeriod": "120s", "perSeriesAligner": "ALIGN_MEAN" >], "jämförelse": "jämförelse_gt", "tröskelvärde": 0.9, "varaktighet": "0s", "trigger": < "count": 1 >>>, "dokumentation": < "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n", "mime_type": "text/markdown" >, "Sammanfattning": "CPU:.835.">," version ":" 1.2 ">
Schemastruktur, version 1.2
Det här avsnittet beskriver version 1.2 i nyttolastdiagrammet. Vissa fält kanske inte visas i alla returnerade paket eller presenterar tomma värden, beroende på konfigurationen av varningsregeln, tillståndet för incidenten eller den övervakade resursen. Vissa fält använder integrerade strukturer som värden. Dessa strukturer beskrivs genom referens, eftersom deras innehåll också kan variera.
I ett returnerat paket kan fälten visas i vilken ordning som helst. I följande beskrivning är de organiserade i relaterade grupper.
<
“version”: “1.2 “,
“incident”:: < Incidentinformation “Incident_id” : kedja; ID genererad för denna incident.
“scoping_project_id” : Kanal, ID för projektet som är värd för mätvärdena.
“Scoping_project_number” : projektnummerövervakning
“URL” : kanal, URL för Google Cloud -konsolen för denna incident.
“Startade_at” : Antal, tid (i sekunder av Epoch Unix) där händelsen öppnades.
“Ended_at” : nummer (i sekunder Epoch Unix) under vilken händelsen stängdes. Endast informerad när staten är stängd .
“Stat” : kedja, villkor för händelsen: öppen eller stängd . Om värdet är öppet är slut_at noll.
“Sammanfattning” : kedja, textöversikt av incidenten genererad.
“apigee_url” : kedja, apigee url av denna incident, endast för de typer av apigee -miljö och proxy* resurser* .
“Observed_value” : kedja, observerat värde efter att ha utlöst/löst varningen, kan vara tomt om tillståndet har löpt ut.Information om den övervakade resursen som händelsen öppnades.
“Resurs”:: <
“snäll” : kedja, identifierare av typen av övervakad resurs med förbehåll för en varning (till exempel gce_instance; se lista över övervakade resurser).
“Etiketter” : Objekt/nyckelvallar för etiketter associerade med den övervakade resursen.
>,
“Resource_type_display_name” : kedja, namn för att visa vilken typ av övervakad resurs.
“Resource_id” : kedja, instans -ID för den övervakade resursen, samma värde som resurs.etiketter.instans_id .
“Resource_display_name” : kedja, namn för att visa övervakade resurser.
“Resursnamn” : kedja, namn som genereras för denna övervakade resurs; Innehåller värdena på andra fält.Information om typen av metriska tidsseriedata.
“Metrisk”:: <
“snäll” : kedja, identifierare av typen av metrisk med förbehåll för en varning (till exempel beräkna.googeapis.com/instans/cpu/användning; Se lista över mätvärden).
“Displayename” : kedja, namn för att visa metrisk typ.
“Etiketter” : Objekt/värdepar för etiketter associerade med mätvärden.
>,
“Metadata”:: <
“System_labels” : Objekt/nyckelparpar för systemmetadatetiketter.
“User_labels” : Objekt/nyckelknappar för användarmetadatetiketter.
>,Information om varningsregeln och villkoret som öppnade/löste händelsen.
Värdena extraheras från det berörda AlertPolicy -objektet.“Policy_name” : kedja, namn för att visa för varningsregeln.
“Policy_user_labels” : Nyckel/värdepar för alla användarformuleringar associerade med regeln.
“dokumentation” : Objekt, struktur integrerad i dokumentationsformat .
“skick” : objekt, struktur integrerad i tillståndsformat .
“Condition_name” : kedja, namn för att visa tillstånd, samma värde som tillstånd.tvist .
“Tröskelvärde” : kedja (tröskelvärde för detta tillstånd) kan vara tomt om tillståndet inte är ett tröskelvillkor.
>,
>Grundläggande autentisering
Förutom begäran från WebHook skickar molnövervakning användarnamnet och lösenordet i enlighet med HTTP -specifikationen för grundläggande autentisering. Cloud Monitoring kräver att din server returnerar ett 401-svar med lämplig www-autentiserad rubrik. Mer information om grundläggande autentisering finns i följande resurser:
Autentisering av token
Autentisering av Token kräver en förfrågningskedjeparameter i URL: n för avslutningspunkten samt nyckeln som servern förväntar sig att vara hemlig mellan sig själv och övervakning. Du hittar nedan ett exempel på URL inklusive ett token:
Om övervakning publicerar en incident på URL: n för uppsägningspunkten, kan din server validera det associerade token. Denna autentiseringsmetod är mer effektiv när den används med SSL/TLS för att kryptera HTTP -begäran för att förhindra att datorhackare lär sig token.
För att få ett exempel på en Python -server, se detta serverexempel.
Regler för övergivande
Nyttolastsystemet omfattas av förordningarna som rör övergivandet av Google Cloud som beskrivs i avsnitt 1.4 (d) Användningsvillkor för Google Cloud Platform. Observera att diagrammet inte styr formaten för de genererade fältvärdena och att dessa format kan ändras utan föregående meddelande. Till exempel händelse.Sammanfattning, incident.dokumentation.glad och händelse.URL är avsedda att inkludera data som tillhör deras fält, men schemat har inga begränsningar för att garantera en exakt analys av dessa fält. Du kan använda värdet som helhet och förvänta dig att det respekterar förordningarna som rör övergivningar, men litar inte på analysen av de genererade fälten.
Pub/sub
Det här avsnittet förklarar hur man konfigurerar pub/submeddelandekanaler. För att säkerställa redundans rekommenderar vi att du skapar flera anmälningskanaler. Vi rekommenderar att du associerar reklam/sub till mobilapplikationen för Google Cloud Console, PagerDuty, Webhooks eller Slacks, eftersom Pub/SU använder en annan distributionsmekanism.
Så här konfigurerar du en pub/submeddelandekanal:
- Aktivera pub/sub -API och skapa ett ämne
- Konfigurera aviseringskanalen för ett ämne
- Auktorisera ett servicekonto
- Definiera anmälningskanalen i en varningsregel
För att förstå datasystemet, se exempel på ett diagram.
För att ta emot varningsmeddelanden måste du också skapa ett av följande prenumerationer: tröja, push eller bigquery.
När prenumerationen är i ett projekt som skiljer sig från ämnet, skapa ett servicekonto i abonnentprojektet och tillskriver rollrollerna/pubsub.anta .
Innan du börjar
När du lägger till den första anmälningskanalen för ett Google Cloud -projekt skapar molnövervakning ett servicekonto för detta projekt. Han ger också rollen Identity and Access Management Service Agent övervakning på servicekontot. Detta servicekonto gör det möjligt för övervakning att skicka aviseringar till anmälningskanaler baserade på pub/su i detta projekt.
Servicekontot har följande format:
service-Project_Number@Gcp-sa-monitoring-notification.jag är.GserviceAccount.com
Namnet på anmälningsservicekontot innehåller ett siffra Google Cloud Project. Du hittar namnet, ID och projektnummer i projektpanelen i Google Cloud -konsolen. Du kan också återställa det med följande kommando:
Gcloud -projekt beskriver Projekt_id --Format = "värde (projekt_number)"
Du kan visa och ändra servicekontot med Google Cloud Console eller Google Cloud.
Aktivera pub/sub -API och skapa ett ämne
- Aktivera Pub/SUP API för ditt Google Cloud -projekt:
Aktivera pub/sub -API- Välj Google Cloud -projektet där du planerar att skapa pub/subämne.
- Klicka på Gör det möjligt När det visas. Ingen åtgärd krävs när meddelandet API aktiverad Visas ut.
Gcloud pubsub ämnen skapar anmälan
Konfigurera sedan dina pub/submeddelandekanaler.
Konfigurera aviseringar för ett ämne
För att skapa en reklam/submeddelande kanal kan du använda övervakningen, Google Cloud CL CL eller Google Cloud Console. Efter att ha skapat Notification Channel, auktorisera meddelandekontot för att publicera varje ämne du använder som en aviseringskanal.
För mer information om hur du använder övervakningen eller Google Cloud API för att skapa aviseringskanalen, se Create -kanaler.
För att skapa aviseringskanalen med Google Cloud -konsolen, fortsätt enligt följande:
- Välj i Google Cloud -konsolen Övervakning, Sedan meddelandenVarna, eller klicka på följande knapp: Åtkomst till varningsgränssnittet
- Välj Google Cloud -projektet som innehåller pub/sub -ämnet du skapade.
- Klicka på Ändra meddelandekanaler.
- I avsnittet Pub/sub, Klicka på Ny. Dialogrutan Skapad pub/subkanal (Pub/Sub Canal) Visar namnet på servicekontot som skapats genom övervakning.
- Auktorisera servicekontot. Ditt servicekonto kan publicera alla ämnen eller specifika ämnen:
- För att publicera alla ämnen, välj Hantera roller och lägg till rollen Förläggare pub/sub. När du är klar med konfigurationen av aviseringskanalen, ignorera nästa avsnitt, med titeln Auktorisera servicekontot, och gå till Definiera meddelandeskanalen i en varningsregel.
- För att publicera specifika ämnen, gå till nästa steg och godkänna servicekontot för att publicera specifika ämnen när meddelandekanalen är konfigurerad. För att få instruktioner, se avsnittet Autorisera servicekontot.
- Ange ett namn som ska visas för din kanal och namnet på puben/subämnet.
- (Valfritt) För att verifiera att kanalen är korrekt konfigurerad, klicka på Skicka ett testmeddelande.
- Välj Lägg till en kedja.
Låt sedan servicekontot.
Auktorisera servicekontot
Lade märke till : Utför detta steg när du skapar meddelandekanalen med API eller Google Cloud CLI, och när du har ignorerat auktorisationssteget när du använder Google Cloud -konsolen.
Autorisation gör det möjligt för Notification Service -kontot att publicera varje pub/SU -ämne som du använder som en aviseringskanal. Det här avsnittet beskriver proceduren att följa för:
- Auktorisera ett servicekonto för ett specifikt ämne.
- Tillåt ett servicekonto för alla ämnen.
Auktorisera ett servicekonto för ett specifikt ämne
Du kan låta ett servicekonto publicera ett specifikt ämne med Google Cloud Console och Google Cloud. Det här avsnittet beskriver båda tillvägagångssätten.
För att godkänna ditt servicekonto för ett specifikt ämne med Google Cloud -konsolen, fortsätt enligt följande:
- Välj i Google Cloud -konsolen Pub/sub, Sedan Teman, eller klicka på följande knapp: komma åt pub/sup -ämnen
- Välj ämnet.
- I fliken Auktorisationer, Välj Lägg till ett huvudkonto.
- På fältet Nytt huvudkonto, Ange namnet på meddelanden om aviseringar. Servicekontot använder följande valörsavtal:
service-Project_Number@Gcp-sa-monitoring-notification.jag är.GserviceAccount.com
För att godkänna ditt servicekonto för ett specifikt ämne med Google Cloud CLI, tilldela IAM PubSub -rollen i servicekontot.Förläggare för ämnet. Till exempel konfigurerar följande kommando IAM -rollen för det anmälningsoptiska ämnet:
Gcloud pubsub ämnen tillägg-iima-policy-bindande \ projekt/Project_Number/Ämnen/NotificationTopic -role = roller/pubsub.Förläggare \ -medlem = service -count: service-Project_Number@Gcp-sa-monitoring-notification.jag är.GserviceAccount.com
Svaret på ett framgångsrikt utförande av kommandot Add-IAM-policybindande presenterar sig på följande sätt:
Uppdaterad IAM -policy för ämne [NotificationTopic]. Bindningar: ‐ Medlemmar: ‐ Service -Discover: Service-Project_Number@Gcp-sa-monitoring-notification.jag är.GserviceAccount.Com roll: roller/pubsub.Utgivare Etag: Bwwcdoiw1pc = version: 1
För mer information, se PUBSUB-ämnen tilläggssida för Jeam-policy-bindande referens .
Auktorisera ett servicekonto för alla ämnen
För att godkänna ditt servicekonto för alla ämnen, fortsätt enligt följande:
- Välj i Google Cloud -konsolen JAG ÄR eller klicka på följande knapp: Åtkomst till IAM
- Välj Inkludera attributen av roller som tillhandahålls av Google, Som illustreras i följande bild:
- Leta efter servicekontot i följande format:
service-Project_Number@Gcp-sa-monitoring-notification.jag är.GserviceAccount.com
Definiera sedan meddelandekanalen i en varningsregel.
Definiera anmälningskanalen i en varningsregel
För att använda en pub/su -anmälan i en varningsregel väljer du vilken typ av kanal Pub/sub, Sedan ämnet.
Exempel på diagram
För att visa ett exempel på JSON -paket och diagram, utveckla följande avsnitt.
JSON -exempel
Som standard försöker Alert Backend generera ett JSON -paket i version 1 -format.2. För mer information om denna formatering, se nästa avsnitt.
Här är ett exempel på denna typ av paket:
< "incident": < "incident_id": "0.opqiw61fsv7p", "scoping_project_id": "internal-project", "scoping_project_number": 12345, "url": "https://console.cloud.google.com/monitoring/alerting/incidents/0.lxfiw61fsv7p?project=internal-project", "started_at": 1577840461, "ended_at": 1577877071, "state": "closed", "resource_id": "11223344", "resource_name": "internal-project gke-cluster-1-default-pool-e2df4cbd-dgp3", "resource_display_name": "gke-cluster-1-default-pool-e2df4cbd-dgp3", "resource_type_display_name": "VM Instance", "resource": < "type": "gce_instance", "labels": < "instance_id": "11223344", "project_id": "internal-project", "zone": "us-central1-c" >>, "Metrisk": < "type": "compute.googleapis.com/instance/cpu/utilization", "displayName": "CPU utilization", "labels": < "instance_name": "the name of the VM instance" >>, "metadata": < "system_labels": < "labelkey": "labelvalue" >, "User_labels": < "labelkey": "labelvalue" >>, "Policy_name": "Monitor-Project-Cluster", "policy_user_labels": < "user-label-1" : "important label", "user-label-2" : "another label" >, "Condition_name": "VM Instans - CPU -användning [max]", "Threshold_value": "0.9 "," observerad_value ":" 0.835 "," Condition ": < "name": "projects/internal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789", "displayName": "VM Instance - CPU utilization [MAX]", "conditionThreshold": < "filter": "metric.type=\\"compute.googleapis.com/instance/cpu/utilization\\" resource.type=\\"gce_instance\\" metadata.system_labels.\\"state\\"=\\"ACTIVE\\"", "aggregations": [ < "alignmentPeriod": "120s", "perSeriesAligner": "ALIGN_MEAN" >], "jämförelse": "jämförelse_gt", "tröskelvärde": 0.9, "varaktighet": "0s", "trigger": < "count": 1 >>>, "dokumentation": < "content": "TEST ALERT\n\npolicy.name=projects/internal-project/alertPolicies/1234567890123456789\n\npolicy.display_name=Monitored-Project-NO-GROUPBY\n\ncondition.name=projects/nternal-project/alertPolicies/1234567890123456789/conditions/1234567890123456789\n\ncondition.display_name=VM Instance - CPU utilization [MAX]\n\nproject=internal-project\n\nresrouce.project=internal-project \n\nDONE\n", "mime_type": "text/markdown" >, "Sammanfattning": "CPU:.835.">," version ":" 1.2 ">
Schemastruktur, version 1.2
Det här avsnittet beskriver version 1.2 i nyttolastdiagrammet. Vissa fält kanske inte visas i alla returnerade paket eller presenterar tomma värden, beroende på konfigurationen av varningsregeln, tillståndet för incidenten eller den övervakade resursen. Vissa fält använder integrerade strukturer som värden. Dessa strukturer beskrivs genom referens, eftersom deras innehåll också kan variera.
I ett returnerat paket kan fälten visas i vilken ordning som helst. I följande beskrivning är de organiserade i relaterade grupper.
<
“version”: “1.2 “,
“incident”:: < Incidentinformation “Incident_id” : kedja; ID genererad för denna incident.
“scoping_project_id” : Kanal, ID för projektet som är värd för mätvärdena.
“Scoping_project_number” : projektnummerövervakning
“URL” : kanal, URL för Google Cloud -konsolen för denna incident.
“Startade_at” : Antal, tid (i sekunder av Epoch Unix) där händelsen öppnades.
“Ended_at” : nummer (i sekunder Epoch Unix) under vilken händelsen stängdes. Endast informerad när staten är stängd .
“Stat” : kedja, villkor för händelsen: öppen eller stängd . Om värdet är öppet är slut_at noll.
“Sammanfattning” : kedja, textöversikt av incidenten genererad.
“apigee_url” : kedja, apigee url av denna incident, endast för de typer av apigee -miljö och proxy* resurser* .
“Observed_value” : kedja, observerat värde efter att ha utlöst/löst varningen, kan vara tomt om tillståndet har löpt ut.Information om den övervakade resursen som händelsen öppnades.
“Resurs”:: <
“snäll” : kedja, identifierare av typen av övervakad resurs med förbehåll för en varning (till exempel gce_instance; se lista över övervakade resurser).
“Etiketter” : Objekt/nyckelvallar för etiketter associerade med den övervakade resursen.
>,
“Resource_type_display_name” : kedja, namn för att visa vilken typ av övervakad resurs.
“Resource_id” : kedja, instans -ID för den övervakade resursen, samma värde som resurs.etiketter.instans_id .
“Resource_display_name” : kedja, namn för att visa övervakade resurser.
“Resursnamn” : kedja, namn som genereras för denna övervakade resurs; Innehåller värdena på andra fält.Information om typen av metriska tidsseriedata.
“Metrisk”:: <
“snäll” : kedja, identifierare av typen av metrisk med förbehåll för en varning (till exempel beräkna.googeapis.com/instans/cpu/användning; Se lista över mätvärden).
“Displayename” : kedja, namn för att visa metrisk typ.
“Etiketter” : Objekt/värdepar för etiketter associerade med mätvärden.
>,
“Metadata”:: <
“System_labels” : Objekt/nyckelparpar för systemmetadatetiketter.
“User_labels” : Objekt/nyckelknappar för användarmetadatetiketter.
>,Information om varningsregeln och villkoret som öppnade/löste händelsen.
Värdena extraheras från det berörda AlertPolicy -objektet.“Policy_name” : kedja, namn för att visa för varningsregeln.
“Policy_user_labels” : Nyckel/värdepar för alla användarformuleringar associerade med regeln.
“dokumentation” : Objekt, struktur integrerad i dokumentationsformat .
“skick” : objekt, struktur integrerad i tillståndsformat .
“Condition_name” : kedja, namn för att visa tillstånd, samma värde som tillstånd.tvist .
“Tröskelvärde” : kedja (tröskelvärde för detta tillstånd) kan vara tomt om tillståndet inte är ett tröskelvillkor.
>,
>Regler för övergivande
Nyttolastsystemet omfattas av förordningarna som rör övergivandet av Google Cloud som beskrivs i avsnitt 1.4 (d) Användningsvillkor för Google Cloud Platform. Observera att diagrammet inte styr formaten för de genererade fältvärdena och att dessa format kan ändras utan föregående meddelande. Till exempel händelse.Sammanfattning, incident.dokumentation.glad och händelse.URL är avsedda att inkludera data som tillhör deras fält, men schemat har inga begränsningar för att garantera en exakt analys av dessa fält. Du kan använda värdet som helhet och förvänta dig att det respekterar förordningarna som rör övergivningar, men litar inte på analysen av de genererade fälten.
Skapa en kedja på begäran
När du lägger till en aviseringskanal till en varningsregel måste du välja en kanal i en lista. För att uppdatera listan med alternativ när du skapar en varningsregel, fortsätt enligt följande:
- Klicka på i dialogrutan för meddelandet Kanalmeddelandehantering (Hantera aviseringskanaler). Du omdirigeras till fönstret Kanalmeddelande (Meddelande kanaler) om en ny flik.
- För att lägga till en ny aviseringskanal, sök efter sin typ, klicka på Ny, Följ sedan instruktionerna som är specifika för kanalen som visas i föregående tabell.
- Återgå till den ursprungliga fliken och klicka på DIALOG -rutan uppdateraUppdatering .
- Välj meddelandekanal från den uppdaterade listan.
Testa en anmälningskanal
Molnövervakning testar inte meddelandekanalerna. Du kan dock verifiera att en anmälningskanal är korrekt konfigurerad genom att skapa en varningsregel och konfigurera villkoret för att den ska utlösas.
Till exempel kan du kontrollera konfigurationen av dina aviseringskanaler genom att tillämpa följande procedur:
- Om ditt Google Cloud -projekt inte inkluderar en datorinstans, skapar du en.
- Skapa en varningsregel för att övervaka användning av processorn av denna kropp. Om ditt Google Cloud -projekt innehåller flera instanser, lägg till ett filter för att välja en enda instans.
- Konfigurera fälten för tillståndsutlösare enligt följande:
- Välj Tröskel på fältet Tillståndstyp.
- Välj Lägre än tröskeln för fältet Tröskelposition.
- Välj ett värde som är större än användningen av processorn för din instans. Till exempel, om grafen indikerar att användningen av processorn är cirka 5%, definierar tröskeln på 10%.
- Utveckla Avancerade alternativ, Välj sedan Inga nya tester för fältet Fönster med längst.
Dessa parametrar konfigurerar regeln så att den utlöses när användningen av processorn för en datorinstans är under den angivna tröskeln. Eftersom du har valt en tröskel högre än användningen av processorn i din instans utlöses villkoret.
Redigera och ta bort meddelandekanaler
För att ändra eller ta bort en meddelandekanal med Google Cloud -konsolen, fortsätt enligt följande:
- Välj i Google Cloud -konsolen Övervakning, Sedan meddelandenVarna, eller klicka på följande knapp: Åtkomst till varningsgränssnittet
- Klicka på Ändra meddelandekanaler. Instrumentbrädan på Meddelande kanaler Innehåller ett avsnitt för varje typ av aviseringskanal. Varje avsnitt visar alla konfigurationer för den här typen:
- Klicka på en inmatning redigeraAtt modifiera. Klicka på Spara När ändringarna gjorts.
- Klicka på Radera för att ta bort en inmatning RADERA. Klicka på RADERA I dialogrutan Bekräftelse.
Visa tidningarna för anmälningskanalen
Du kan använda tidningsutforskaren för att visa fel i meddelandekanalen:
- Välj i Google Cloud -konsolen Skogsavverkning, Sedan Tidningsutforskare, eller klicka på följande knapp: Åtkomst till tidningsutforskaren
- Ange och kör din begäran. För specifika förfrågningar om fel i aviseringskanaler, se avsnittet om molnövervakningsförfrågningar.
Kommentar
Om inget annat anges styrs innehållet på denna sida av en kreativ Commons -uppdrag 4 -licens.0, och kodprover styrs av en Apache 2 -licens.0. Mer information finns i reglerna för Google Developers -webbplatsen. Java är ett registrerat varumärke som tillhör Oracle och/eller dess anslutna företag.
Senaste uppdateringen 2023/08/26 (UTC).
Google Notification
Formmeddelanden om e -postmeddelanden
Skicka e -postmeddelanden, generera PDF, certifikat, fakturor, nyhetsbrev, professionella dokument, integrera dem i Slack, Zappier, Google Chat eller andra applikationer.
Uppdateringsark: 20 september 2023
Mer information om användarrecensioner
Med hjälp av "Form E -postmeddelanden" (efter formulärmeddelande) kan du skicka personliga e -postmeddelanden, generera fakturor, certifikat, nyhetsbrev, kommersiella brev och andra PDF -filer och perfekta dokument. Du kan hitta detaljerad information om vad den extra modulen kan göra för dig genom att besöka vår Form Notify HTTPS -webbplats: // www.formnotifiera.com/produkt genom att använda detta kan du (ägare av formuläret) - varna vem som helst genom att automatiskt skicka en rik html e -mail - skapa, konfigurera och anpassa meddelandet med e -mail för formella respondenter - skicka en e -post personlig till Respondenter och andra anställda - genererar perfekta PDF -filer till närmaste pixel, till exempel en faktura, ett nyhetsbrev, ett certifikat, ett kommersiellt brev eller något annat professionellt aspektdokument - begränsa formuläret genom att öppna och genom att stänga enligt ett specifikt datum och/eller/eller En timmes återkommande tid - Returnera formens tidigare svar - Konfigurera flera processorer som kan skicka e -postmeddelanden till olika mottagare - tillfälligt avbryta sändningen av aviseringar - smärta genom att generera dokumentet -Gå med i en PDF till dina e -postmeddelanden - Använd uttryck för att anpassa värdet enligt formsvaren - Integrera QR -koden i e -posten - Importera och exportera dina konfigurerade data - varna alla människor du vill ha genom att konfigurera webbkrokar och Integrera dem i applikationer som Google Chat, Slack, Zappier, IFTTTT eller andra webbtjänster - Meddela användare via telefon via Push Notification - Integration med alla applikationer som använder HTTP REST. - Importera och export av webbkrokar - skicka frågesportpoängen till föräldrar som en del av meddelandet - håll formuläret öppet under vissa perioder utvecklade av anmälningsformulär (https: // formnotify.com) För att rapportera problem med denna ytterligare modul, besök https: // formulär.GLE/TSMVVAFVWLJEXAAV7
ytterligare information
Inte tillgängliga priser
Sekretess
Villkor
Formmeddelanden om e -postmeddelanden kommer att be dig om behörigheterna nedan. Lär dig mer
Formmeddelanden måste komma åt ditt Google -konto
Formmeddelanden kan således utföra följande åtgärder:
Konsultera, ändra, skapa och ta bort alla dina Google Docs -dokument
Visa, skapa och ta bort dina egna konfigurationsdata i Google Drive
Visa, skapa och ta bort dina egna konfigurationsdata i Google Drive
Konsultera, modifiera, skapa och ta bort de specifika Google Drive -filerna som du använder med den här applikationen
Visa och hantera de formulär där denna applikation har installerats