Naar hoofdinhoud gaan
De meeste CLI-commando’s werken op één enkele applicatie in één enkele omgeving, dus voordat u logs tailt of incidents lijst, moet u weten welke apps u heeft en hoe u ze moet benoemen. Deze pagina behandelt het opsommen van uw applicaties, het instellen van een standaardorganisatie en het inspecteren van de resources van een app.

Organisaties

Uw applicaties leven onder een organisatie, geïdentificeerd door zijn slug: de korte naam in uw AppSignal-URL, appsignal.com/<org-slug>. De CLI werkt met de organisatie die gekoppeld is aan uw aangemelde account.

Een standaardorganisatie instellen

De meeste commando’s vallen terug op een standaardorganisatie, zodat u niet elke keer --org hoeft mee te geven. Door appsignal-cli apps list uit te voeren wordt de organisatie van uw account bepaald en als standaard opgeslagen. Om deze zelf in te stellen of te wijzigen:
Shell
appsignal-cli apps set-org --org <YOUR_ORG_SLUG>
Om de huidige standaard te bekijken:
Shell
appsignal-cli apps show-org
U kunt de standaard ook instellen tijdens het aanmelden met appsignal-cli auth login --org <YOUR_ORG_SLUG>, of per project met appsignal-cli project init --org <YOUR_ORG_SLUG>. Zie Authenticatie voor hoe de globale en projectlokale configuraties zich tot elkaar verhouden.

Applicaties

Om de applicaties voor de organisatie van uw account op te sommen:
Shell
appsignal-cli apps list
Dit slaat ook uw organisatie op als de standaard voor latere commando’s, zodat u --org niet hoeft mee te geven.

Een app op naam vinden

Om een specifieke app op naam op te zoeken, optioneel beperkt tot één omgeving:
Shell
appsignal-cli apps find --name "MyApp" --environment production
De naam en omgeving zijn beide hoofdletterongevoelig. Dit is de snelste manier om de exacte appnaam en omgeving te bevestigen die andere commando’s verwachten.

Details voor een app weergeven

Als u het ID van een app kent, kunt u de details ervan direct ophalen:
Shell
appsignal-cli apps info --app-id <APP_ID>

Hoe commando’s een app identificeren

Commando’s die op een enkele app werken, accepteren deze op één van twee manieren:
  • Op naam: --app "MyApp". Voeg --environment production alleen toe wanneer meer dan één app dezelfde naam deelt.
  • Op ID: --app-id <APP_ID>, de waarde uit de ID-kolom van appsignal-cli apps list (een lange hexadecimale string). Een ID identificeert op zichzelf een specifieke app en omgeving, dus u geeft --environment er niet bij door.
Gebruik wat u heeft. Een naam is makkelijker te lezen en typen; het ID is ondubbelzinnig en handig in scripts.

De resources van een app inspecteren

De apps resources-commando’s tonen de configuratie en metadata die aan een app zijn gekoppeld:
CommandoToont
apps resources allAlle onderstaande resources, in één aanroep
apps resources usersGebruikers met toegang tot de app
apps resources notifiersGeconfigureerde notifiers
apps resources namespacesDe namespaces van de app
apps resources dashboardsCustom dashboards
apps resources deploy-markersRecente deploy markers
Elk gebruikt dezelfde app-selector als andere commando’s, ofwel --app met --environment of --app-id, en gebruikt uw standaardorganisatie tenzij u --org meegeeft. Bijvoorbeeld, om de namespaces voor een app te zien:
Shell
appsignal-cli apps resources namespaces --app "MyApp" --environment production
Om alles in één keer op te halen als JSON, om door te geven aan een andere tool:
Shell
appsignal-cli apps resources all --app "MyApp" --environment production --output json

Volgende stappen

Zodra u de naam en omgeving van een app kent, kunt u beginnen met het opvragen ervan. Inspecteer zijn incidents of tail zijn logs vanuit de terminal.